Microsoft DirectX 8.0 (C++)

IDirectMusicSong8::GetParam

DirectX 8.0 では実装されていない。

このソングのトラックからデータを取得する。

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

パラメータ

rguidType
取得されるデータ型の識別子への参照 (C++) またはアドレス (C)。「標準トラック パラメータ」を参照すること。
dwGroupBits
目的のトラックが置かれているグループ。すべてのグループを指定するには、この値を 0xFFFFFFFF に設定する。「注意」を参照すること。
dwIndex
データの取得に使われるグループ内で、トラックに割り当てられているインデックス。
mtTime
データを取得するタイム。パフォーマンス時間で指定する。
pmtNext
データが無効になるタイム (mtTime からの相対タイム) を受け取る変数のアドレス。この変数が値 0 を返した場合、データが常に有効になっているか、データが無効になるタイムが不明であることを意味する。この情報が不要な場合は、pmtNext を NULL に設定してもよい。
pParam
パラメータ データを受け取るバッファのアドレス。

戻り値

成功した場合は S_OK または DMUS_S_GARBAGE_COLLECTED を返す。「ガベージ コレクション」を参照すること。

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

DMUS_E_GET_UNSUPPORTED
DMUS_E_NOT_FOUND
DMUS_E_TRACK_NOT_FOUND
E_POINTER

動作環境

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