Platform SDK: DirectX

IDirectMusicPerformance::GetSegmentState

IDirectMusicPerformance::GetSegmentState メソッドは、現在演奏中のプライマリ セグメント状態、または特定の時点で演奏されているプライマリ セグメント状態を取り出す。

HRESULT GetSegmentState(
  IDirectMusicSegmentState ** ppSegmentState, 
  MUSIC_TIME mtTime
);

パラメータ

ppSegmentState
セグメント状態へのポインタを受け取る変数のアドレス。呼び出し元は、このポインタに対して Release を呼び出す責任がある。
mtTime
セグメント状態が取り出されるタイム。

戻り値

成功すれば S_OK を返す。

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

DMUS_E_NOT_FOUND
E_POINTER

注意

現在演奏されているセグメント状態を取得するには、IDirectMusicPerformance::GetTime メソッドを使って返されるタイムを渡す。現在演奏されているセグメント状態は、現在メッセージを生成しているセグメントを表す。遅延時間が存在するため、必ずしも現在演奏されているセグメント状態が現在スピーカから実際に聞こえているとは限らない。

動作環境

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