Platform SDK: DirectX

DirectSoundBuffer.GetCaps

DirectSoundBuffer.GetCaps メソッドは、バッファの能力を取得する。

object.GetCaps(caps As DSBCAPS)

パラメータ

object
DirectSoundBuffer オブジェクトを表すオブジェクト式。
caps
サウンド バッファの能力を保持している DSBCAPS 型。

エラー コード

失敗すればエラーが発生し、Err.NumberDSERR_INVALIDPARAM が設定される。

注意

DSBCAPS 型は、DirectSound.CreateSoundBuffer メソッドに渡される DSBUFFERDESC 型と同等の情報に加えて、いくつかの追加情報を保持している。この情報として、バッファの位置 (ハードウェアとソフトウェアのどちらか) と、コスト測定値が挙げられる。コスト測定値の例には、ハードウェア バッファへのダウンロード所要時間、バッファがソフトウェア内に配置されている場合のミキシングや再生処理のオーバーヘッドが含まれる。

DSBCAPS 型の lFlags メンバ内のフラグは、DSBUFFERDESC 型で使われるフラグと同じものである。唯一の違いは、DSBCAPS 型ではバッファ メモリの場所に応じて DSBCAPS_LOCHARDWARE と DSBCAPS_LOCSOFTWARE のどちらかが指定されることである。DSBUFFERDESC 型ではこれらのフラグはオプションであり、フラグの指定に応じて、バッファをハードウェアとソフトウェアのどちらかに強制的に配置できる。