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

参照