IDirectSound8::SetSpeakerConfig
Specifies the speaker configuration of the DirectSound object.
It is not recommended that applications use this method. See Speaker Configuration.
HRESULT SetSpeakerConfig(
DWORD dwSpeakerConfig
);
Parameters
- dwSpeakerConfig
- Speaker configuration of the specified DirectSound object. This parameter can be one of the following values:
- DSSPEAKER_5POINT1
- The audio is played through a speaker arrangement of surround speakers with a subwoofer.
- 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 can 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.
Return Values
If the method succeeds, the return value is DS_OK.
If the method fails, the return value may be one of the following error values:
Remarks
If a geometry value is to be used, it must be packed in a DWORD along with the DSSPEAKER_STEREO flag. This can be done by using the DSSPEAKER_COMBINED macro, as in the following C++ example:
lpds->SetSpeakerConfig(DSSPEAKER_COMBINED(
DSSPEAKER_STEREO, DSSPEAKER_GEOMETRY_WIDE));
Header: Declared in dsound.h.
See Also
IDirectSound8::GetSpeakerConfig