DSCAPS
DirectSound デバイスの能力を記述する。DirectSound8.GetCaps メソッドで使われる。
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 つ以上の定数を指定する。
- lFreeHw3DAllBuffers
- 未割り当ての 3D バッファの数。
- lFreeHw3DStaticBuffers
- 未割り当てのスタティック 3D バッファの数。
- lFreeHw3DStreamingBuffers
- 未割り当てのストリーム 3D バッファの数。
- lFreeHwMemBytes
- サウンド カードの空きメモリのサイズ (バイト単位)。
- lFreeHwMixingAllBuffers
- 未割り当てのバッファの数。WDM ドライバでは、lFreeHw3DAllBuffers を含む。
- lFreeHwMixingStaticBuffers
- 未割り当てのスタティック バッファの数。
- lFreeHwMixingStreamingBuffers
- 未割り当てのストリーム バッファの数。
- lMaxContigFreeHwMemBytes
- サウンド カード上の空きメモリのうち、最大の連続ブロックのサイズ (バイト単位)。
- lMaxHw3DAllBuffers
- 3D バッファの最大数。
- lMaxHw3DStaticBuffers
- スタティック 3D バッファの最大数。
- lMaxHw3DStreamingBuffers
- ストリーム 3D バッファの最大数。
- lMaxHwMixingAllBuffers
- ハードウェアでミキシングできるバッファの合計数。このメンバには lMaxHwMixingStaticBuffers と lMaxHwMixingStreamingBuffers の合計より小さい値を指定する。リソースのトレードオフがしばしば発生する。
- lMaxHwMixingStaticBuffers
- スタティック サウンド バッファの最大数。
- lMaxHwMixingStreamingBuffers
- ストリーム サウンド バッファの最大数。
- lMaxSecondarySampleRate、lMinSecondarySampleRate
- このデバイスのハードウェア セカンダリ サウンド バッファがサポートする最小と最大のサンプリング レートの仕様。
- lPlayCpuOverheadSwBuffers
- (メイン システム メモリ内の) ソフトウェア バッファをミキシングするのに必要な処理オーバーヘッドを、CPU パーセンテージで記述した値。この値は、バス タイプ、プロセッサ タイプ、およびクロック速度に応じて変化する。
ソフトウェア バッファのアンロック転送速度は、データをどこにも転送する必要がないため 0 である。同様に、ハードウェア バッファの再生オーバーヘッドも、ミキシングがサウンド デバイスによって処理されるため 0 である。
- lPrimaryBuffers
- サポートされているプライマリ バッファの数。この値は常に 1 である。
- lReserved1、lReserved2
- 予約済み。
- lTotalHwMemBytes
- スタティック サウンド バッファを保持するサウンド カード上のメモリ容量のサイズ (バイト単位)。
- lUnlockTransferRateHwBuffers
- ハードウェア スタティック サウンド バッファへのデータ転送速度。 単位は 1 秒あたりのキロバイト (KB/s)。
注意
オーディオ サウンド カードによっては、利用可能なハードウェア バッファやその空きを正確に報告できない場合がある。これはたとえば、カードが、高いサンプリング レートよりも低いサンプリング レートでより多くのサウンドを再生できるときに発生する。通常、ハードウェア バッファの空き数に関係するメンバの値が 0 以外の場合は、適切なタイプのハードウェア リソースが少なくとも 1 つ利用できることを示している。