IXAPOParameters::GetParameters method (xapo.h)

Gets the current values for any effect-specific parameters.

Syntax

void GetParameters(
  [in, out] void   *pParameters,
  [in]      UINT32 ParameterByteSize
);

Parameters

[in, out] pParameters

Receives an effect-specific parameter block.

[in] ParameterByteSize

Size of pParameters, in bytes.

Return value

None

Remarks

The data in pParameters is completely effect-specific and determined by the implementation of the IXAPOParameters::GetParameters function. The data returned in pParameters can be used to provide information about the current state of the XAPO.

Unlike SetParameters, XAudio2 does not call this method on the realtime audio processing thread. Thus, the XAPO must protect variables shared with IXAPOParameters::SetParameters or IXAPO::Process using appropriate synchronization. The CXAPOParametersBase class is an implementation of IXAPOParameters and its implementation of GetParameters efficiently handles this synchronization for the user.

XAudio2 calls this method from the IXAudio2Voice::GetEffectParameters method.

This method may block and should never be called from the realtime audio processing thread instead get the current parameters from CXAPOParametersBase::BeginProcess.

Platform Requirements

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Requirements

Requirement Value
Target Platform Windows
Header xapo.h

See also

IXAPOParameters

IXAudio2Voice::GetEffectParameters