DSBCAPS

The DSBCAPS type describes the capabilities of a buffer object. It is used in the DirectSoundPrimaryBuffer8.GetCaps and DirectSoundSecondaryBuffer8.GetCaps method.

Syntax

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 DirectSound8.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 returned, 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.