Class DSCaps

In this topic

Package com.ms.directX Previous This
Package Next

Class DSCaps

public final class DSCaps
{
  // Fields
  public int flags;
  public int freeHw3DAllBuffers;
  public int freeHw3DStaticBuffers;
  public int freeHw3DStreamingBuffers;
  public int freeHwMemBytes;
  public int freeHwMixingAllBuffers;
  public int freeHwMixingStaticBuffers;
  public int freeHwMixingStreamingBuffers;
  public int maxContigFreeHwMemBytes;
  public int maxHw3DAllBuffers;
  public int maxHw3DStaticBuffers;
  public int maxHw3DStreamingBuffers;
  public int maxHwMixingAllBuffers;
  public int maxHwMixingStaticBuffers;
  public int maxHwMixingStreamingBuffers;
  public int maxSecondarySampleRate;
  public int minSecondarySampleRate;
  public int playCpuOverheadSwBuffers;
  public int primaryBuffers;
  public int totalHwMemBytes;
  public int unlockTransferRateHwBuffers;
}

Specifies the capabilities of a DirectSound device for use by the getCaps method.

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 may 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.