Platform SDK: DirectX |
IDirectSoundBuffer::GetCaps メソッドは、DirectSoundBuffer オブジェクトの能力を取得する。
HRESULT GetCaps( LPDSBCAPS lpDSBufferCaps );
成功すれば DS_OK、失敗すれば DSERR_INVALIDPARAM を返す。
DSBCAPS 構造体は、IDirectSound::CreateSoundBuffer メソッドに渡される DSBUFFERDESC 構造体と同等の情報に加えて、いくつかの追加情報を保持している。追加情報として、バッファの位置 (ハードウェアまたはソフトウェア) と、コスト測定値が挙げられる。コスト測定値には、ハードウェア バッファへのダウンロード所要時間、バッファがシステム メモリ内に配置されている場合のミキシングや再生処理のオーバーヘッドが含まれる。
DSBCAPS 構造体の dwFlags メンバ内で指定されるフラグは、DSBUFFERDESC 構造体で使われるフラグと同じものである。唯一の違いは、DSBCAPS 構造体ではバッファ メモリの場所に応じて DSBCAPS_LOCHARDWARE と DSBCAPS_LOCSOFTWARE のどちらかが指定されることである。DSBUFFERDESC 構造体ではこれらのフラグはオプションであり、フラグの指定に応じて、バッファをハードウェアとソフトウェアのどちらかに強制的に配置できる。
Windows NT/2000 : Service Pack 3 を適用した Windows NT バージョン 4.0 以降が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dsound.h で宣言。
インポート ライブラリ : dsound.lib を使用。
DSBCAPS、DSBUFFERDESC、IDirectSoundBuffer、IDirectSound::CreateSoundBuffer