Microsoft DirectX 8.0 (C++)

DirectSound Interfaces

This section contains references for methods of the following DirectSound interfaces:

For DirectX 8.0, only IDirectSound8, IDirectSoundBuffer8, and IDirectSoundCaptureBuffer8 are new interfaces that supersede interfaces with similar, unnumbered names. Other interface names ending in 8 are simple defines for unchanged or new unnumbered interfaces. For example, IDirectSoundCapture8 is exactly equivalent to IDirectSoundCapture.

All interfaces that have a define ending in 8 are documented under that defined name, and it is recommended that you always use this name in your code. When recompiling for future versions, you can substitute the latest number in all your declarations and be sure of getting the latest version of any updated interfaces.

When a method takes an interface pointer as a parameter, you can pass in the newer version even where the method is declared as accepting the older version. For example, a pointer to either IDirectSoundBuffer or IDirectSoundBuffer8 can be passed to IDirectSound8::DuplicateSoundBuffer as the pDSBufferOriginal parameter.

When a method returns an interface, however, it is usually the older interface, and the newer interface must be obtained by using QueryInterface. This is the case, for example, with the ppDSBuffer parameter of IDirectSound8::CreateSoundBuffer.