DirectSound.GetCaps

The DirectSound.GetCaps method retrieves the capabilities of the hardware device represented by the DirectSound object.

object.GetCaps(caps As DSCAPS)

Parameters

object

Object expression that resolves to a DirectSound object.

caps

DSCAPS type to contain the capabilities of this sound device.

Error Codes

If the method fails, an error is raised and Err.Number may be one of the following error values.

Remarks

Information retrieved in the DSCAPS type describes the maximum capabilities of the sound device and those currently available, such as the number of hardware mixing channels and the amount of on-board sound memory. You can use this information to fine-tune performance and optimize resource allocation.

Because of resource-sharing requirements, the maximum capabilities in one area might be available only at the cost of another area. For example, the maximum number of hardware-mixed streaming sound buffers might be available only if there are no hardware static sound buffers.

See Also

DirectX7.DirectSoundCreate