IDirectSoundBuffer8::GetCaps
バッファ オブジェクトの能力を取得する。
構文
HRESULT GetCaps(
LPDSBCAPS
pDSBufferCaps
);
パラメータ
pDSBufferCaps
サウンド バッファの能力が格納される DSBCAPS 構造体のアドレス。
戻り値
成功した場合は DS_OK を返す。
失敗した場合は DSERR_INVALIDPARAM を返す。
注意
DSBCAPS 構造体は、IDirectSound8::CreateSoundBuffer メソッドに渡される DSBUFFERDESC 構造体と同様の情報に加えて、いくつかの追加情報を保持している。追加情報としては、バッファの位置 (ハードウェアまたはソフトウェア) やパフォーマンス測定値などがある。
DSBCAPS 構造体の dwFlags メンバで指定されるフラグは、DSBUFFERDESC 構造体で使われるフラグと同じものである。唯一の違いは、DSBCAPS 構造体ではバッファ メモリの場所に応じて DSBCAPS_LOCHARDWARE と DSBCAPS_LOCSOFTWARE のどちらかが指定されることである。DSBUFFERDESC 構造体ではこれらのフラグはオプションであり、フラグの指定に応じて、バッファはハードウェアとソフトウェアのどちらかに強制的に配置される。
要件
** ヘッダー:**dsound.h で宣言。
参照