Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::GetParamEx

トラックからデータを取得する。このメソッドは、IDirectMusicPerformance8::GetParam に類似しているが、自己制御セグメントのサポートを追加する。主にツールで使用される。

HRESULT GetParamEx(
  REFGUID rguidType, 
  DWORD dwTrackID,
  DWORD dwGroupBits,
  DWORD dwIndex, 
  MUSIC_TIME mtTime,
  MUSIC_TIME* pmtNext,
  void* pParam
);

パラメータ

rguidType
取得されるデータ型の識別子への参照 (C++) またはアドレス (C)。「標準トラック パラメータ」を参照すること。
dwTrackID
パラメータの取得に使われるセグメント状態内のトラックの一意な識別子。トラックから取得される各パフォーマンス メッセージには、メッセージを生成したトラック インスタンスの識別子が付いている。この識別子は、メッセージ構造体の DMUS_PMSG 部分の dwVirtualTrackID メンバに保持される。この値が GetParamEx に渡されると、制御セグメントではない同じセグメント内の別のトラックからデータを取得した場合に、このトラックが自己制御しているかどうかを判断できる。
dwGroupBits
トラックが属するグループ (「注意」を参照すること)。すべてのグループを指定するには、この値を 0xFFFFFFFF に設定する。
dwIndex
グループ内のトラックのインデックス。
mtTime
データを取得するタイム。パフォーマンス時間で指定する。
pmtNext
データが有効になるタイム (mtTime からの相対タイム) を受け取る変数のアドレス。この変数が値 0 を返した場合、データが常に有効になっているか、データが無効になるタイムが不明であることを意味する。この情報が不要な場合は、pmtNext を NULL に設定してもよい。「注意」を参照すること。
pParam
返されるデータの保存用に割り当てられた構造体のアドレス。返されるデータの保存用に割り当てられた構造体のアドレス。この構造体は、rguidType で識別されたデータ型にとって適切な種類とサイズを備えていなければならない。

戻り値

成功した場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DMUS_E_GET_UNSUPPORTED
DMUS_E_NO_MASTER_CLOCK
DMUS_E_NOT_FOUND
DMUS_E_TRACK_NOT_FOUND
E_POINTER

注意

各トラックは 1 つまたは複数のグループに所属するが、各グループは dwGroupBits 内のビットによって表されている。詳細については、「IDirectMusicSegment8::InsertTrack」および「トラックの識別」を参照すること。

動作環境

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

参照

IDirectMusicPerformance8::SetParamIDirectMusicSegment8::GetParamIDirectMusicTrack8::GetParamExIDirectMusicPerformance8::SetGlobalParamIDirectMusicPerformance8::GetTimeパフォーマンス パラメータ