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
Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | xapo.h |