XACT3DInitialize

Initializes the 3D API's.

HRESULT XACT3DInitialize(
  UINT32 SpeakerChannelMask,
  IXACTEngine* pEngine,
  X3DAUDIO_HANDLE X3DInstance
);

Parameters

SpeakerChannelMask
[in] Assignment of channels to speaker positions. XACT currently only supports stereo and 5.1 speaker arrangements. The following #define values in X3DAudio.h can be used to easily set up these configurations:
SPEAKER_STEREO Stereo Sound (Equivalent to SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT)
SPEAKER_5POINT1 5.1 Sound (Equivalent to SPEAKER_FRONT_LEFT | SPEAKER_FRONT_RIGHT | SPEAKER_FRONT_CENTER | SPEAKER_LOW_FREQUENCY | SPEAKER_BACK_LEFT | SPEAKER_BACK_RIGHT)
pEngine
[in] Pointer to the XACT engine.
X3DInstance
[out] Handle to the X3DAudio instance.

Return Values

Returns S_OK if successful, an error code otherwise.

Remarks

This method only needs to be called once.

Requirements

Header: Declared in Xact3d.h.

See Also

XACT Functions