Platform SDK: DirectX

IDirectSoundBuffer::GetCaps

IDirectSoundBuffer::GetCaps メソッドは、DirectSoundBuffer オブジェクトの能力を取得する。

HRESULT GetCaps(
  LPDSBCAPS lpDSBufferCaps  
);

パラメータ

lpDSBufferCaps
DSBCAPS 構造体のアドレス。この構造体は、サウンド バッファの能力を保持している。

戻り値

成功すれば 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 を使用。

参照

DSBCAPSDSBUFFERDESCIDirectSoundBufferIDirectSound::CreateSoundBuffer