Microsoft DirectX 8.0 (C++)

IDirectMusicSegment8::InitPlay

演奏状態を初期化する。このメソッドは内部的に使用されるものであり、DirectX 7.0 より後のバージョンには実装されていない。

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

パラメータ

ppSegState
IDirectMusicSegmentState8 インターフェイスへのポインタを受け取る変数のアドレス。このインターフェイスはこのメソッドを呼び出したときに作成され、状態データを保持するために使われる。参照カウントが 1 になって返されるので、Release メソッドを呼び出すと、このインターフェイスは完全に解放される。
pPerformance
IDirectMusicPerformance8 インターフェイスのアドレス。パフォーマンス オブジェクトに対してこのメソッドを呼び出すために、セグメントとセグメント状態はこのインターフェイスを必要とする。
dwFlags
トラックの動作を変更する DMUS_SEGF_FLAGS

戻り値

DirectX 8.0 以降では E_NOTIMPL を返す。

それ以前のバージョンでは、成功した場合は S_OK を返す。失敗した場合は、次のいずれかのエラー値を返す。

E_POINTER
E_OUTOFMEMORY

動作環境

  ヘッダー : dmusici.h で宣言。