DirectSound3DBuffer.GetMode

The DirectSound3DBuffer.GetMode method retrieves the current operation mode for 3-D sound processing.

object.GetMode() As CONST_DS3DMODEFLAGS

Parameters

object

Object expression that resolves to a DirectSound3DBuffer object.

Return Values

If the method succeeds, the return value contains the current mode setting. This value will be one of the following constants of the CONST_DS3DMODEFLAGS enumeration:

DS3DMODE_DISABLE

Processing of 3-D sound is disabled. The sound seems to originate from the center of the listener's head.

DS3DMODE_HEADRELATIVE

Sound parameters (position, velocity, and orientation) are relative to the listener's parameters. In this mode, the absolute parameters of the sound are updated automatically as the listener's parameters change, so that the relative parameters remain constant.

DS3DMODE_NORMAL

Normal processing. This is the default mode.

Error Codes

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