Microsoft DirectX 8.0 (C++)

IDirectMusicPerformance8::GetGlobalParam

パフォーマンスからグローバル値を取得する。

HRESULT GetGlobalParam(
  REFGUID rguidType, 
  void* pParam,
  DWORD dwSize
);

パラメータ

rguidType
データ型の識別子への参照 (C++) またはアドレス (C)。
pParam
データのコピーを受け取るために割り当てられたメモリへのポインタ。pParam には正しいサイズを指定しなければならない。サイズは各データ型について一定である。このパラメータは、IDirectMusicPerformance8::SetGlobalParam メソッドに渡された情報を保持する。
dwSize
データのサイズ。rguidType ごとに一定の値である。

戻り値

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

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

E_INVALIDARG
E_POINTER

注意

SetGlobalParamrguidType について一度も呼び出されたことがない場合、このパフォーマンスが現在処理しているグローバル データ リストの中に、rguidType がない可能性がある。その場合、このメソッドは E_INVALIDARG を返す。つまり、どのパラメータにも、GetGlobalParam を使って取得できるデフォルト値があると想定しないこと。

動作環境

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

参照

IDirectMusicPerformance8::SetGlobalParamIDirectMusicPerformance8::GetParamパフォーマンス パラメータ