PyDSCAPS Object

A Python object, representing a DSCAPS structure

Properties

integer dwFlags

Specifies device capabilities. Can be one or more of the following:

Flag	Description
DSCAPS_PRIMARYMONO	The device supports monophonic primary buffers.
DSCAPS_PRIMARYSTEREO	The device supports stereo primary buffers.
DSCAPS_PRIMARY8BIT	The device supports hardware-mixed secondary buffers with 8-bit samples.
DSCAPS_PRIMARY16BIT	The device supports primary sound buffers with 16-bit samples.
DSCAPS_CONTINUOUSRATE	The device supports all sample rates between the dwMinSecondarySampleRate and dwMaxSecondarySampleRate member values. Typically, this means that the actual output rate will be within +/- 10 hertz (Hz) of the requested frequency.
DSCAPS_EMULDRIVER	The device does not have a DirectSound driver installed, so it is being emulated through the waveform-audio functions. Performance degradation should be expected.
DSCAPS_CERTIFIED	This driver has been tested and certified by Microsoft.
DSCAPS_SECONDARYMONO	The device supports hardware-mixed monophonic secondary buffers.
DSCAPS_SECONDARYSTEREO	The device supports hardware-mixed stereo secondary buffers.
DSCAPS_SECONDARY8BIT	The device supports hardware-mixed secondary buffers with 8-bit samples.
DSCAPS_SECONDARY16BIT	The device supports hardware-mixed secondary sound buffers with 16-bit samples.

integer dwMinSecondarySampleRate

Minimum sample rate supported by this device's hardware secondary sound buffers.

integer dwMaxSecondarySampleRate

Maximum sample rate supported by this device's hardware secondary sound buffers.

integer dwPrimaryBuffers

Number of primary buffers supported. This value will always be 1.

integer dwMaxHwMixingAllBuffers

Specifies the total number of buffers that can be mixed in hardware. This member can be less than the sum of dwMaxHwMixingStaticBuffers and dwMaxHwMixingStreamingBuffers. Resource tradeoffs frequently occur.

integer dwMaxHwMixingStaticBuffers

Specifies the maximum number of static sound buffers.

integer dwMaxHwMixingStreamingBuffers

Specifies the maximum number of streaming sound buffers.

integer dwFreeHwMixingAllBuffers

Description of the free hardware mixing capabilities of the device. An application can use this value to determine whether hardware resources are available for allocation to a secondary sound buffer. Also, by comparing these values to the members that specify maximum mixing capabilities, the resources that are already allocated can be determined.

integer dwFreeHwMixingStaticBuffers

Description of the free hardware mixing capabilities of the device. An application can use this value to determine whether hardware resources are available for allocation to a secondary sound buffer. Also, by comparing these values to the members that specify maximum mixing capabilities, the resources that are already allocated can be determined.

integer dwFreeHwMixingStreamingBuffers

Description of the free hardware mixing capabilities of the device. An application can use this value to determine whether hardware resources are available for allocation to a secondary sound buffer. Also, by comparing these values to the members that specify maximum mixing capabilities, the resources that are already allocated can be determined.

integer dwMaxHw3DAllBuffers

Description of the hardware 3-D positional capabilities of the device.

integer dwMaxHw3DStaticBuffers

Description of the hardware 3-D positional capabilities of the device.

integer dwMaxHw3DStreamingBuffers

Description of the hardware 3-D positional capabilities of the device.

integer dwFreeHw3DAllBuffers

Description of the free, or unallocated, hardware 3-D positional capabilities of the device.

integer dwFreeHw3DStaticBuffers

Description of the free, or unallocated, hardware 3-D positional capabilities of the device.

integer dwFreeHw3DStreamingBuffers

Description of the free, or unallocated, hardware 3-D positional capabilities of the device.

integer dwTotalHwMemBytes

Size, in bytes, of the amount of memory on the sound card that stores static sound buffers.

integer dwFreeHwMemBytes

Size, in bytes, of the free memory on the sound card.

integer dwMaxContigFreeHwMemBytes

Size, in bytes, of the largest contiguous block of free memory on the sound card.

integer dwUnlockTransferRateHwBuffers

Description of the rate, in kilobytes per second, at which data can be transferred to hardware static sound buffers. This and the number of bytes transferred determines the duration of a call to the IDirectSoundBuffer::Update method.

integer 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 need not be transferred anywhere. Similarly, the play processing overhead for hardware buffers is 0 because the mixing is done by the sound device.