Platform SDK: DirectX

DSCAPS

DSCAPS 型は、DirectSound.GetCaps メソッドが使う DirectSound デバイスの能力を指定する。

Type DSCAPS
    lFlags As CONST_DSCAPSFLAGS
    lFreeHw3DAllBuffers As Long
    lFreeHw3DStaticBuffers As Long
    lFreeHw3DStreamingBuffers As Long
    lFreeHwMemBytes As Long
    lFreeHwMixingAllBuffers As Long
    lFreeHwMixingStaticBuffers As Long
    lFreeHwMixingStreamingBuffers As Long
    lMaxContigFreeHwMemBytes As Long
    lMaxHw3DAllBuffers As Long
    lMaxHw3DStaticBuffers As Long
    lMaxHw3DStreamingBuffers As Long
    lMaxHwMixingAllBuffers As Long
    lMaxHwMixingStaticBuffers As Long
    lMaxHwMixingStreamingBuffers As Long
    lMaxSecondarySampleRate As Long
    lMinSecondarySampleRate As Long
    lPlayCpuOverheadSwBuffers As Long
    lPrimaryBuffers As Long
    lReserved1 As Long
    lReserved2 As Long
    lTotalHwMemBytes As Long
    lUnlockTransferRateHwBuffers As Long
End Type

メンバ

lFlags
デバイスの能力。CONST_DSCAPSFLAGS 列挙からの定数の 1 つまたは複数を指定する。
lFreeHw3DallBufferslFreeHw3DstaticBufferslFreeHw3DStreamingBuffers
空きまたは未割り当てのデバイスのハードウェア 3D 定位能力の記述。
lFreeHwMemBytes
サウンド カードの空きメモリのサイズ。単位はバイト。
lFreeHwMixingAllBuffers, lFreeHwMixingStaticBufferslFreeHwMixingStreamingBuffers
空きまたは未割り当てのデバイスのハードウェア ミキシング能力の記述。アプリケーションはこれらの値を使って、セカンダリ サウンド バッファの割り当てにハードウェア リソースが利用可能かどうかを判断できる。また、最大のミキシング能力を指定するメンバとこれらの値を比較すると、既に割り当てられているリソースを決定できる。
lMaxContigFreeHwMemBytes
サウンド カード上の空きメモリのうち、最大の連続ブロックのサイズ。単位はバイト。
lMaxHw3DallBufferslMaxHw3DstaticBufferslMaxHw3DStreamingBuffers
デバイスのハードウェア 3D 定位能力の記述。
lMaxHwMixingAllBuffers
ハードウェアでミキシングできるバッファの合計数。このメンバは lMaxHwMixingStaticBufferslMaxHwMixingStreamingBuffers の合計より小さい値を取る。リソースのトレードオフがしばしば発生する。
lMaxHwMixingStaticBuffers
スタティック サウンド バッファの最大数。
lMaxHwMixingStreamingBuffers
ストリーム サウンド バッファの最大数。
LMaxSecondarySampleRatelMinSecondarySampleRate
このデバイスのハードウェア セカンダリ サウンド バッファがサポートする最小と最大のサンプリング レートの仕様。
lPlayCpuOverheadSwBuffers
(メイン システム メモリ内の) ソフトウェア バッファをミキシングするのに必要な処理オーバーヘッドを、CPU パーセンテージで記述した値。この値は、バス タイプ、プロセッサ タイプ、およびクロック速度に応じて変化する。

ソフトウェア バッファのアンロック転送速度は、データをどこにも転送する必要がないため 0 である。同様に、ハードウェア バッファの再生オーバーヘッドも、ミキシングがサウンド デバイスによって処理されるため 0 である。

lPrimaryBuffers
サポートされているプライマリ バッファの数。この値は常に 1 である。
lReserved1lReserved2
将来の使用に予約。
lTotalHwMemBytes
スタティック サウンド バッファを保持するサウンド カード上のメモリ容量のサイズ。単位はバイト。
lUnlockTransferRateHwBuffers
ハードウェア スタティック サウンド バッファへのデータ転送速度。単位は 1 秒あたりのキロバイト (KB/s)。