KSPROPERTY_DIRECTSOUND3DBUFFER_MODE

The KSPROPERTY_DIRECTSOUND3DBUFFER_MODE property specifies the processing mode of a 3D sound buffer.

The property value (operation data) is of type ULONG and specifies the sound buffer's processing mode. The mode can have one of the following values, which are defined in header file dsound.h:

• DS3DMODE_NORMAL
• DS3DMODE_HEADRELATIVE
• DS3DMODE_DISABLE

The meaning of these parameters is explained in the Platform SDK documentation.

Return Value

A KSPROPERTY_DIRECTSOUND3DBUFFER_MODE property request returns STATUS_SUCCESS to indicate that it has completed successfully. Otherwise, the request returns an appropriate error status code.

Headers

Declared in ksmedia.h. Include ksmedia.h.

Comments

For additional information on the processing mode for a DirectSound 3D buffer, see the following in the Platform SDK documentation:

• The dwMode member of the DS3DBUFFER structure.
• The IDirectSound3DBuffer::GetMode and IDirectSound3DBuffer::SetMode methods.

See Also

KSNODEPROPERTY