IXAPOParameters::GetParameters method
Gets the current values for any effect-specific parameters.
Syntax
virtual void GetParameters( [in, out] void *pParameters, [in] UINT32 ParameterByteSize ) = 0;
Parameters
- pParameters [in, out]
-
Receives an effect-specific parameter block.
- ParameterByteSize [in]
-
Size of pParameters, in bytes.
Return value
This method does not return a value.
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
|
Header |
|
|---|
See also