Platform SDK: DirectX

DSBCAPS

The DSBCAPS type describes the capabilities of a DirectSoundBuffer object and is used in the DirectSoundBuffer.GetCaps method.

Type DSBCAPS
    lBufferBytes As Long
    lFlags As CONST_DSBCAPSFLAGS
    lPlayCpuOverhead As Long
    lUnlockTransferRate As Long
End Type

Members

lBufferBytes
Size of the buffer, in bytes.
lFlags
One of more of the constants of the CONST_DSBCAPSFLAGS enumeration.
lPlayCpuOverhead
Processing overhead, specified as a percentage of main processing cycles needed to mix this sound buffer. For hardware buffers, this value is zero, because the mixing is performed by the sound device. For software buffers, the value depends on the buffer format and the speed of the system processor.
lUnlockTransferRate
Rate, in kilobytes per second, at which data is transferred to the buffer memory.

Remarks

The DSBCAPS type contains information similar to that found in the DSBUFFERDESC type passed to the DirectSound.CreateSoundBuffer method.

The lFlags member of the DSBCAPS type contains the same flags used by the DSBUFFERDESC type. The only difference is that in the DSBCAPS type, either the DSBCAPS_LOCHARDWARE or DSBCAPS_LOCSOFTWARE flag is specified, according to the location of the buffer memory. In the DSBUFFERDESC type, these flags are optional and are used to force the buffer to be located in either hardware or software.