Platform SDK: DirectX

IDirectMusicPerformance::GetGlobalParam

IDirectMusicPerformance::GetGlobalParam メソッドは、パフォーマンスからグローバル値を取り出す。

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

パラメータ

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

戻り値

成功すれば S_OK を返す。

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

E_INVALIDARG
E_POINTER

注意

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

動作環境

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

参照

IDirectMusicPerformance::SetGlobalParamIDirectMusicPerformance::GetParamミュージック パラメータ