IXAPOParameters::GetParameters-Methode (xapo.h)

Ruft die aktuellen Werte für alle effektspezifischen Parameter ab.

Syntax

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

Parameter

[in, out] pParameters

Empfängt einen effektspezifischen Parameterblock.

[in] ParameterByteSize

Größe von pParameters in Bytes.

Rückgabewert

Keine

Bemerkungen

Die Daten in pParameters sind vollständig effektspezifisch und durch die Implementierung der IXAPOParameters::GetParameters-Funktion bestimmt. Die in pParameters zurückgegebenen Daten können verwendet werden, um Informationen über den aktuellen Zustand des XAPO bereitzustellen.

Im Gegensatz zu SetParameters ruft XAudio2 diese Methode nicht für den Echtzeit-Audioverarbeitungsthread auf. Daher muss das XAPO Variablen schützen, die mit IXAPOParameters::SetParameters oder IXAPO::P rocess freigegeben werden, indem die entsprechende Synchronisierung verwendet wird. Die CXAPOParametersBase-Klasse ist eine Implementierung von IXAPOParameters , und die Implementierung von GetParameters verarbeitet diese Synchronisierung für den Benutzer effizient.

XAudio2 ruft diese Methode von der IXAudio2Voice::GetEffectParameters-Methode auf.

Diese Methode kann blockieren und sollte nie aus dem Echtzeit-Audioverarbeitungsthread aufgerufen werden, sondern ruft stattdessen die aktuellen Parameter aus CXAPOParametersBase::BeginProcess ab.

Plattformanforderungen

Anforderungen

Weitere Informationen

IXAPOParameters

IXAudio2Voice::GetEffectParameters