Class DSCaps

Package com.ms.com.directX

Previous

Microsoft Packages

Index

Next

Class DSCaps

public final class DSCaps {
  public int dwSize;
  public int dwFlags;
  public int dwMinSecondarySampleRate;
  public int dwMaxSecondarySampleRate;
  public int dwPrimaryBuffers;
  public int dwMaxHwMixingAllBuffers;
  public int dwMaxHwMixingStaticBuffers;
  public int dwMaxHwMixingStreamingBuffers;
  public int dwFreeHwMixingAllBuffers;
  public int dwFreeHwMixingStaticBuffers;
  public int dwFreeHwMixingStreamingBuffers;
  public int dwMaxHw3DAllBuffers;
  public int dwMaxHw3DStaticBuffers;
  public int dwMaxHw3DStreamingBuffers;
  public int dwFreeHw3DAllBuffers;
  public int dwFreeHw3DStaticBuffers;
  public int dwFreeHw3DStreamingBuffers;
  public int dwTotalHwMemBytes;
  public int dwFreeHwMemBytes;
  public int dwMaxContigFreeHwMemBytes;
  public int dwUnlockTransferRateHwBuffers;
  public int dwPlayCpuOverheadSwBuffers;
  public int dwReserved1;
  public int dwReserved2;
}

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

Fields

dwSize: Size of this class, in bytes.
dwFlags: One or more values of DSCAPS_ type, specifying device capabilities.
dwMinSecondarySampleRate and dwMaxSecondarySampleRate: Minimum and maximum sample rate specifications that are supported by this device's hardware secondary sound buffers.
dwPrimaryBuffers: Number of primary buffers supported. This value will always be 1 for this release.
dwMaxHwMixingAllBuffers: Specifies the total number of buffers that can be mixed in hardware.
dwMaxHwMixingStaticBuffers: Specifies the maximum number of static sound buffers.
dwMaxHwMixingStreamingBuffers: Specifies the maximum number of streaming sound buffers.
Note The value for dwMaxHwMixingAllBuffers may be less than the sum of dwMaxHwMixingStaticBuffers and dwMaxHwMixingStreamingBuffers. Resource trade-offs frequently occur.
dwFreeHwMixingAllBuffers, dwFreeHwMixingStaticBuffers, and dwFreeHwMixingStreamingBuffers: Description of the free, or unallocated, hardware mixing capabilities of the device. These 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.
dwMaxHw3DAllBuffers, dwMaxHw3DStaticBuffers, and dwMaxHw3DStreamingBuffers: Description of the hardware 3D positional capabilities of the device. These will all be 0 for the first release.
dwFreeHw3DAllBuffers, dwFreeHw3DStaticBuffers, and dwFreeHw3DStreamingBuffers: Description of the free, or unallocated, hardware 3D positional capabilities of the device. These will all be 0 for the first release.
dwTotalHwMemBytes: Size, in bytes, of the amount of memory on the sound card that stores static sound buffers.
dwFreeHwMemBytes: Size, in bytes, of the free memory on the sound card.
dwMaxContigFreeHwMemBytes: Size, in bytes, of the largest contiguous block of free memory on the sound card.
dwUnlockTranferRateHwBuffers: 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.
dwPlayCpuOverheadSwBuffers: 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.
dwReserved1 and dwReserved2: These values are reserved. Do not use.