Microsoft DirectX 8.0 (Visual Basic)

DirectSound3DListener8.GetOrientation

Retrieves the listener's orientation in 3-D space.

object.GetOrientation( _
  orientFront As D3DVECTOR, _
  orientTop As D3DVECTOR)

Parts

object
Resolves to a DirectSound3DListener8 object.
orientFront
D3DVECTOR type that receives the listener's front orientation vector.
orientTop
D3DVECTOR type that receives the listener's top orientation vector.

Error Codes

If the method fails, an error is raised and Err.Number may be set to DSERR_INVALIDPARAM.

Remarks

The front vector points in the direction of the listener's nose, and the top vector points in the direction of 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 DirectSound3DListener8.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.

See Also

Listener Orientation