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