Packages
 In this topic

*Fields

 

Packages   PreviousThis PackageNext
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.

upnrm.gif © 1998 Microsoft Corporation. All rights reserved. Terms of use.