KSPROPERTY_DIRECTSOUND3DBUFFER_MODE

  • Article

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

Usage Summary Table

Get Set Target Property descriptor type Property value type

Yes

Yes

Pin

KSNODEPROPERTY

ULONG

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 Microsoft Windows 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.

Remarks

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

  • The dwMode member of the DS3DBUFFER structure.

  • The IDirectSound3DBuffer::GetMode and IDirectSound3DBuffer::SetMode methods.

Requirements

Header

 Ksmedia.h (include Ksmedia.h)

See also

KSNODEPROPERTY