IXACTCue::SetMatrixCoefficients

Sets channel volume mapping values.

HRESULT SetMatrixCoefficients(
  UINT32 uSrcChannelCount,
  UINT32 uDstChannelCount,
  float* pMatrixCoefficients
);

Parameters

uSrcChannelCount

The number of source channels the matrix was calculated for.

uDstChannelCount

The number of channels the final mix is to be calculated for. This value may be 2 (Stereo) or 6 (5.1 surround).

pMatrixCoefficients

Matrix coefficient table. This is an array representing the volume level of each source channel present in each destination channel, with the source channels being the column index and the destination channels being the row index of the table. It must have at least (SrcChannelCount×DstChannelCount) elements.

Return Values

Returns S_OK if successful, an error code otherwise.

Requirements

Header: Declared in Xact.h.

See Also

X3DAUDIO_DSP_SETTINGS