Microsoft SDK for Java

DSCaps Class Fields

The DSCaps Class contains the following fields.

flags One or more values of DSCAPS type, specifying device capabilities.
freeHw3DAllBuffers Description of the free, or unallocated, hardware 3D positional capabilities of the device.
freeHw3DStaticBuffers Description of the free, or unallocated, hardware 3D positional capabilities of the device.
freeHw3DStreamingBuffers Description of the free, or unallocated, hardware 3D positional capabilities of the device. These will all be 0 for the first release.
freeHwMemBytes Size, in bytes, of the free memory on the sound card.
freeHwMixingAllBuffers Description of the free hardware mixing capabilities of the device.
freeHwMixingStaticBuffers Description of the free hardware mixing capabilities of the device.
freeHwMixingStreamingBuffers Description of the free, or unallocated, hardware mixing capabilities of the device. These freeHwMixing values can be used by an application to determine whether hardware resources are available for allocation to a secondary sound buffer. Also, by comparing these values to the fields that specify maximum mixing capabilities, the resources that are already allocated can be determined.
maxContigFreeHwMemBytes Size, in bytes, of the largest contiguous block of free memory on the sound card.
maxHw3DAllBuffers Description of the hardware 3D positional capabilities of the device. These will all be 0 for the first release.
maxHw3DStaticBuffers Description of the hardware 3D positional capabilities of the device. These will all be 0 for the first release.
maxHw3DStreamingBuffers Description of the hardware 3D positional capabilities of the device.
maxHwMixingAllBuffers Specifies the total number of buffers that can be mixed in hardware.
maxHwMixingStaticBuffers Specifies the maximum number of static sound buffers.
maxHwMixingStreamingBuffers Specifies the maximum number of streaming sound buffers.

Note   The value for maxHwMixingAllBuffers might be less than the sum of maxHwMixingStaticBuffers and maxHwMixingStreamingBuffers. Resource trade-offs frequently occur.

maxSecondarySampleRate Maximum sample rate specification that is supported by this device's hardware secondary sound buffers.
minSecondarySampleRate Minimum sample rate specification that is supported by this device's hardware secondary sound buffers.
playCpuOverheadSwBuffers Description of the processing overhead, as a percentage of the central processing unit, needed to mix software buffers (those located in main system memory). This varies according to the bus type, the processor type, and the clock speed.

The unlock transfer rate for software buffers is 0 because the data does not need to be transferred anywhere. Similarly, the play processing overhead for hardware buffers is 0 because the mixing is done by the sound device.

primaryBuffers Number of primary buffers supported. This value will always be 1 for this release.
totalHwMemBytes Size, in bytes, of the amount of memory on the sound card that stores static sound buffers.
unlockTransferRateHwBuffers Description of the rate, in kilobytes per second, at which data can be transferred to hardware static sound buffers (those located in onboard sound memory). This and the number of bytes transferred determines the duration of a call to the unlock method.

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