Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::InitPlay

Initializes the play state. This method was for internal use and is not implemented in versions later than DirectX 7.0.

HRESULT InitPlay(
  IDirectMusicSegmentState** ppSegState, 
  IDirectMusicPerformance* pPerformance,
  DWORD dwFlags
);

Parameters

ppSegState
Address of a variable that receives a pointer to the IDirectMusicSegmentState8 interface that is created in response to this method call and is used to hold state data. It is returned with a reference count of 1, so a call to its Release method fully releases it.
pPerformance
Address of the IDirectMusicPerformance8 interface. This is needed by the segment and segment state to call methods on the performance object.
dwFlags
DMUS_SEGF_FLAGS that modify the track's behavior.

Return Values

In DirectX 8.0 and later, the method returns E_NOTIMPL.

In earlier versions, if the method succeeds, the return value is S_OK. If it fails, it can return one of the following error values:

E_POINTER
E_OUTOFMEMORY

Requirements

  Header: Declared in dmusici.h.