The DSCAPS structure specifies the capabilities of a DirectSound device for use by the IDirectSound::GetCaps method.
typedef {
DWORD dwSize;
DWORD dwFlags;
DWORD dwMinSecondarySampleRate;
DWORD dwMaxSecondarySampleRate;
DWORD dwPrimaryBuffers;
DWORD dwMaxHwMixingAllBuffers;
DWORD dwMaxHwMixingStaticBuffers;
DWORD dwMaxHwMixingStreamingBuffers;
DWORD dwFreeHwMixingAllBuffers;
DWORD dwFreeHwMixingStaticBuffers;
DWORD dwFreeHwMixingStreamingBuffers;
DWORD dwMaxHw3DAllBuffers;
DWORD dwMaxHw3DStaticBuffers;
DWORD dwMaxHw3DStreamingBuffers;
DWORD dwFreeHw3DAllBuffers;
DWORD dwFreeHw3DStaticBuffers;
DWORD dwFreeHw3DStreamingBuffers;
DWORD dwTotalHwMemBytes;
DWORD dwFreeHwMemBytes;
DWORD dwMaxContigFreeHwMemBytes;
DWORD dwUnlockTransferRateHwBuffers;
DWORD dwPlayCpuOverheadSwBuffers;
DWORD dwReserved1;
DWORD dwReserved2;
} DSCAPS, *LPDSCAPS;
typedef const DSCAPS *LPCDSCAPS;
Size of the structure, in bytes. This member must be initialized before the structure is used.
DSCAPS_CERTIFIED | |
This driver has been tested and certified by Microsoft. | |
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_PRIMARY16BIT | |
The device supports primary sound buffers with 16-bit samples. | |
DSCAPS_PRIMARY8BIT | |
The device supports primary buffers with 8-bit samples. | |
DSCAPS_PRIMARYMONO | |
The device supports monophonic primary buffers. | |
DSCAPS_PRIMARYSTEREO | |
The device supports stereo primary buffers. | |
DSCAPS_SECONDARY16BIT | |
The device supports hardware-mixed secondary sound buffers with 16-bit samples. | |
DSCAPS_SECONDARY8BIT | |
The device supports hardware-mixed secondary buffers with 8-bit samples. | |
DSCAPS_SECONDARYMONO | |
The device supports hardware-mixed monophonic secondary buffers. | |
DSCAPS_SECONDARYSTEREO | |
The device supports hardware-mixed stereo secondary buffers. |
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.
Windows NT: Use version 4.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in dsound.h.