Microsoft SDK for Java

getCaps

This method of the DirectSoundBuffer Class retrieves the capabilities of the DirectSoundBuffer object.

Syntax

public void getCaps(DSBCaps caps);

Parameters

caps A DSBCaps object that receives the capabilities of this sound buffer.

Remarks

The DSBCaps object contains similar information to the DSBufferDesc object passed to the createSoundBuffer method, with some additional information. This additional information can include the location of the buffer, either in hardware or software, and some cost measures. Examples of cost measures include the time it takes to download to a hardware buffer and the processing overhead required to mix and play the buffer when it is in the system memory.

The flags specified in the flags field of the DSBCaps object are the same flags used by the DSBufferDesc object. The only difference is that in the DSBCaps object, either DSBCAPS_LOCHARDWARE or DSBCAPS_LOCSOFTWARE will be specified according to the location of the buffer memory. In the DSBufferDesc object, these flags are optional and, depending on which flag is specified, force the buffer to be located in either hardware or software.

See Also

com.ms.directX.DirectSound, com.ms.directX.DSBCaps, com.ms.directX.DSBufferDesc

© 1999 Microsoft Corporation. All rights reserved. Terms of use.