IXAudio2Voice::GetEffectParameters-Methode (xaudio2.h)
Gibt die aktuellen effektspezifischen Parameter eines bestimmten Effekts in der Effektkette der Stimme zurück.
Syntax
\\HRESULT GetEffectParameters(
[in] UINT32 EffectIndex,
[out] void *pParameters,
[out] UINT32 ParametersByteSize
);
Parameter
[in] EffectIndex
Nullbasierter Index eines Effekts innerhalb der Effektkette der Stimme.
[out] pParameters
Gibt die aktuellen Werte der effektspezifischen Parameter zurück.
[out] ParametersByteSize
Größe des pParameters-Arrays in Bytes.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück, andernfalls einen Fehlercode. Beschreibungen von Fehlercodes finden Sie unter XAudio2-Fehlercodes .
Schlägt mit E_NOTIMPL fehl, wenn der Effekt keine generische Parametersteuerungsschnittstelle unterstützt.
Hinweise
GetEffectParameters gibt immer die aktuellen Parameter des Effekts zurück. Diese stimmen jedoch möglicherweise nicht mit den Parametern überein, die durch den letzten Aufruf von IXAudio2Voice::SetEffectParameters festgelegt wurden: Die tatsächlichen Parameter werden nur bei der nächsten Ausführung der Audio-Engine nach dem IXAudio2Voice::SetEffectParameters-Aufruf (oder nach dem entsprechenden IXAudio2:CommitChanges-Aufruf geändert, wenn IXAudio2Voice::SetEffectParameters mit einer verzögerten Vorgangs-ID aufgerufen wurde).
Plattformanforderungen
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | xaudio2.h |