| Microsoft DirectX 8.1 (Visual Basic) |
The GetCaps method retrieves the capabilities of the hardware device represented by the DirectSound8 object.
Syntax
object.GetCaps(caps As DSCAPS)
Parts
object
Resolves to a DirectSound8 object.
caps
DSCAPS type that receives 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.
| DSERR_GENERIC |
| DSERR_UNINITIALIZED |
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.