Microsoft DirectX 8.0 (C++) |
Retrieves the listener's orientation in vectors: a front vector and a top vector.
HRESULT GetOrientation( D3DVECTOR * pvOrientFront, D3DVECTOR * pvOrientTop );
If the method succeeds, the return value is DS_OK.
If the method fails, the return value may be DSERR_INVALIDPARAM.
The front vector points in the direction of the listener's nose, and the top vector points out the top of the listener's head. By default, the front vector is (0,0,1.0) and the top vector is (0,1.0,0).
The values returned are not necessarily the same as those set by using the IDirectSound3DListener8::SetOrientation method. DirectSound adjusts orientation vectors so that they are at right angles and have a magnitude of less than or equal to 1.0.
Header: Declared in dsound.h.