Microsoft DirectX 8.0 (Visual Basic)

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
ハードウェアでミキシングできるバッファの合計数。このメンバには lMaxHwMixingStaticBufferslMaxHwMixingStreamingBuffers の合計より小さい値を指定する。リソースのトレードオフがしばしば発生する。
lMaxHwMixingStaticBuffers
スタティック サウンド バッファの最大数。
lMaxHwMixingStreamingBuffers
ストリーム サウンド バッファの最大数。
lMaxSecondarySampleRate、lMinSecondarySampleRate
このデバイスのハードウェア セカンダリ サウンド バッファがサポートする最小と最大のサンプリング レートの仕様。
lPlayCpuOverheadSwBuffers
(メイン システム メモリ内の) ソフトウェア バッファをミキシングするのに必要な処理オーバーヘッドを、CPU パーセンテージで記述した値。この値は、バス タイプ、プロセッサ タイプ、およびクロック速度に応じて変化する。

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

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

注意

オーディオ サウンド カードによっては、利用可能なハードウェア バッファやその空きを正確に報告できない場合がある。これはたとえば、カードが、高いサンプリング レートよりも低いサンプリング レートでより多くのサウンドを再生できるときに発生する。通常、ハードウェア バッファの空き数に関係するメンバの値が 0 以外の場合は、適切なタイプのハードウェア リソースが少なくとも 1 つ利用できることを示している。