IAudioProcessingObjectNotifications::HandleNotification-Methode (audioengineextensionapo.h)

Wird vom System aufgerufen, um Clients über Änderungen an APO-Endpunkten oder Systemeffekten zu benachrichtigen.

Syntax

void HandleNotification(
  APO_NOTIFICATION *apoNotification
);

Parameter

apoNotification

Eine APO_NOTIFICATION , die die APO-Änderung darstellt, die der Benachrichtigung zugeordnet ist.

Rückgabewert

Keine

Bemerkungen

Geben Sie den Satz von APO-Änderungen an, für die diese Methode aufgerufen wird, indem Sie IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo implementieren.

Diese Methode wird aufgerufen, nachdem LockForProcess aufgerufen wurde, und wird vor UnlockForProcess nicht mehr aufgerufen. Wenn im Flight Benachrichtigungen vorhanden sind, werden diese möglicherweise während oder nach UnlockForProcess ausgeführt. In diesem Fall muss der APO die Synchronisierung verarbeiten.

Hinweis

APOs müssen jede Eigenschaft einmal abfragen, um ihren Anfangswert abzurufen, da die HandleNotification-Methode nur aufgerufen wird, wenn sich eine der Eigenschaften geändert hat. Ausnahmen sind das anfängliche Audioendpunktvolume, wenn sich der APO für APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME registriert, und der Wert von PKEY_AudioEndpoint_Disable_SysFx, wenn der APO für APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE

Weitere Informationen zu den Windows 11-APIs für die Audioverarbeitungsobjekte (Audio Processing Objects, APOs), die mit Audiotreibern ausgeliefert werden können, finden Sie unter Windows 11 APIs für Audioverarbeitungsobjekte.

Anforderungen

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