Platform SDK: DirectX

IDirectMusicSegment::InitPlay

IDirectMusicSegment::InitPlay は、セグメントが演奏される直前に、パフォーマンスによって呼び出される。

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

パラメータ

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

戻り値

成功すれば S_OK を返す。

失敗すれば次のエラー値のいずれかを返す。

E_POINTER
E_OUTOFMEMORY

注意

このメソッドは、DirectMusic によって内部的に使われるものであり、アプリケーションから呼び出してはならない。このメソッドは将来のバージョンではサポートされない。

セグメントを演奏する直前に、パフォーマンス エンジンは InitPlay メソッドを呼び出す。次にこのセグメントは IDirectMusicTrack::InitPlay メソッドを呼び出して各トラックの状態オブジェクトを収集し、その結果をセグメント状態のオブジェクトに保存する。IDirectMusicSegmentState インターフェイスを使うと、このオブジェクトにアクセスできる。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dmusici.h で宣言。