Microsoft DirectX 8.1 (C++)

IDirectSound3DBuffer8::GetConeOrientation

The GetConeOrientation method retrieves the orientation of the sound projection cone for this sound buffer.

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 IDirectSound3DBuffer8::SetConeOrientation method. DirectSound adjusts orientation vectors so that they are have a magnitude of less than or equal to 1.0.

Requirements

  Header: Declared in dsound.h.

See Also