IAudioEffectsManager::GetAudioEffects-Methode (audioclient.h)

  • Artikel

Ruft die aktuelle Liste der Audioeffekte für den zugeordneten Audiodatenstrom ab.

Syntax

HRESULT GetAudioEffects(
  AUDIO_EFFECT **effects,
  UINT32       *numEffects
);

Parameter

effects

Empfängt einen Zeiger auf ein Array von AUDIO_EFFECT Strukturen, die die aktuelle Liste der Audioeffekte darstellen.

numEffects

Empfängt die Anzahl der AUDIO_EFFECT Strukturen, die in Effekten zurückgegeben werden.

Rückgabewert

Gibt ein HRESULT zurück, einschließlich, aber nicht beschränkt auf Folgendes.

Wert BESCHREIBUNG
S_OK Erfolg
AUDCLNT_E_DEVICE_INVALIDATED Der zugeordnete Audiodatenstrom wurde zerstört.

Hinweise

Der Aufrufer ist für die Freigabe des Arrays mit CoTaskMemFree verantwortlich.

Registrieren Sie einen IAudioEffectsChangedNotificationClient , um Benachrichtigungen zu erhalten, wenn sich die Liste der Audioeffekte ändert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Build 22000
Kopfzeile audioclient.h

Weitere Informationen

AUDIO_EFFECTIAudioEffectsChangedNotificationClient