XACT3DCalculate

Calculates 3D positional audio information between an X3DAUDIO_LISTENER and an X3DAUDIO_EMITTER.

HRESULT XACT3DCalculate(
  X3DAUDIO_HANDLE X3DInstance,
  const X3DAUDIO_LISTENER* pListener,
  X3DAUDIO_EMITTER* pEmitter,
  X3DAUDIO_DSP_SETTINGS* pDSPSettings
);

Parameters

X3DInstance

[in] X3DAudio instance (returned from XACT3DInitialize).

pListener

[in] Defines the listener object that will be used to calculate positional audio effects.

pEmitter

[in] Defines the emitter object that will be used to calculate positional audio effects.

pDSPSettings

[out] Pointer that receives the 3D calculation data. This value can be applied to a cue by calling XACT3DApply.

Return Values

Returns S_OK if successful, an error code otherwise.

Remarks

If the pChannelAzimuths parameter of pEmitter is set to NULL, XACT will automatically calculate the azimuth values of the emitter if the number of channels is 2, 3, 4, 6, or 8. Otherwise, the function will fail.

Requirements

Header: Declared in Xact3d.h.

Import Library: Use X3daudio.lib.

See Also

XACT Functions