IDirectSound3DBuffer8::GetConeOrientation

The GetConeOrientation method retrieves the orientation of the sound projection cone.

Syntax

HRESULT GetConeOrientation(
  D3DVECTOR * pvOrientation 
);

Parameters

pvOrientation

Address of a D3DVECTOR structure that receives the orientation of the sound projection cone. The vector information represents the center of the sound cone.

Return Values

If the method succeeds, the return value is DS_OK.

If the method fails, the return value may be DSERR_INVALIDPARAM.

Remarks

The values returned are not necessarily the same as those set by using the SetConeOrientation method. DirectSound normalizes orientation vectors so that all axes have a magnitude of less than or equal to 1.0.

Requirements

  Header: Declared in dsound.h.

See Also

• IDirectSound3DBuffer8 Interface
• IDirectSound3DBuffer8::SetConeAngles
• IDirectSound3DBuffer8::SetConeOrientation
• IDirectSound3DBuffer8::SetConeOutsideVolume
• Sound Cones