DirectSoundSecondaryBuffer8.GetCaps

The GetCaps method retrieves the capabilities of the buffer.

Syntax

object.GetCaps(caps As DSBCAPS)

Parts

object

Resolves to a DirectSoundSecondaryBuffer8 object.

caps

DSBCAPS type that receives the capabilities of the buffer.

Error Codes

If the method fails, an error is raised and Err.Number may be set to DSERR_INVALIDPARAM.

Remarks

The DSBCAPS type is similar to the DSBUFFERDESC type passed to the DirectSound8.CreateSoundBuffer method, with additional information. This information can include the buffer's location, either in hardware or software, and performance measures.

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