Microsoft DirectX 8.0 (C++)

IDirectSoundBuffer8::GetCaps

DirectSoundBuffer オブジェクトの能力を取得する。

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 で宣言。

参照

DSBCAPSDSBUFFERDESCIDirectSound8::CreateSoundBuffer