DirectX SDK

DirectSound.SetSpeakerConfig

The DirectSound.SetSpeakerConfig method specifies the speaker configuration of the DirectSound object.

object.SetSpeakerConfig( _
    speakerConfig As CONST_DSSPEAKERFLAGS)

Parameters

object
Object expression that resolves to a DirectSound object.
speakerConfig
Speaker configuration of the specified DirectSound object. This parameter can be one of the following constants of the CONST_DSSPEAKERFLAGS enumeration:
DSSPEAKER_HEADPHONE
The speakers are headphones.
DSSPEAKER_MONO
The speakers are monaural.
DSSPEAKER_QUAD
The speakers are quadraphonic.
DSSPEAKER_STEREO
The speakers are stereo (default value).
DSSPEAKER_SURROUND
The speakers are surround sound.
DSSPEAKER_STEREO may be combined with one of the following values:
DSSPEAKER_GEOMETRY_WIDE
The speakers are directed over an arc of 20 degrees.
DSSPEAKER_GEOMETRY_NARROW
The speakers are directed over an arc of 10 degrees.
DSSPEAKER_GEOMETRY_MIN
The speakers are directed over an arc of 5 degrees.
DSSPEAKER_GEOMETRY_MAX
The speakers are directed over an arc of 180 degrees.

Error Codes

If the method fails, an error is raised and Err.Number may be one of the following error values:

DSERR_INVALIDPARAM
DSERR_UNINITIALIZED

Remarks

The speaker geometry is by default set to 0 which states that the speaker geometry has not been defined. The geometry must be explicitly set by using the passing one of the speaker geometry flags with the DSSPEAKER_STEREO flag.

See Also

DirectSound.GetSpeakerConfig