IDirectSound3DListener::GetOrientation
The IDirectSound3DListener::GetOrientation method retrieves the listener's current orientation in vectors: a front vector and a top vector.
HRESULT GetOrientation(
LPD3DVECTOR lpvOrientFront,
LPD3DVECTOR lpvOrientTop
);
Parameters
lpvOrientFront
Address of a D3DVECTOR structure that will contain the listener's front orientation vector.
lpvOrientTop
Address of a D3DVECTOR structure that will contain the listener's top orientation vector.
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 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 IDirectSound3DListener::SetOrientation method. DirectSound adjusts orientation vectors so that they are at right angles and have a magnitude of <= 1.0.
QuickInfo
Windows NT: Use version 5.0 or later.
Windows: Use Windows 95 OSR2 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in dsound.h.
Import Library: Use dsound.lib.
See Also