IXAudio2Voice::GetEffectParameters-Methode (xaudio2.h)

  • Artikel

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

Weitere Informationen

IXAPOParameters::GetParameters

IXAudio2Voice

XAPO–Übersicht