APO_NOTIFICATION-Struktur (audioengineextensionapo.h)

Stellt eine Benachrichtigung für eine Änderung an einem APO-Endpunkt oder Systemeffekten dar.

Syntax

typedef struct APO_NOTIFICATION {
  APO_NOTIFICATION_TYPE type;
  union {
    AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION        audioEndpointVolumeChange;
    AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION      audioEndpointPropertyChange;
    AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION audioSystemEffectsPropertyChange;
    AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2       audioEndpointVolumeChange2;
    DEVICE_ORIENTATION_TYPE                          deviceOrientation;
    AUDIO_MICROPHONE_BOOST_NOTIFICATION              audioMicrophoneBoostChange;
    AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION      audioEnvironmentChange;
  } DUMMYUNIONNAME;
} APO_NOTIFICATION;

Member

type

Ein Wert aus der APO_NOTIFICATION_TYPE-Enumeration , die den Typ der Änderung angibt, die die Benachrichtigung darstellt.

DUMMYUNIONNAME

DUMMYUNIONNAME.audioEndpointVolumeChange

Wenn type APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME ist, ist der Union-Wert ein AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION , der eine Benachrichtigung über eine Änderung des APO-Endpunktvolumes darstellt.

DUMMYUNIONNAME.audioEndpointPropertyChange

Wenn type APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE ist, ist der Union-Wert ein AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION, der eine Benachrichtigung über eine Änderung an einer APO-Endpunkteigenschaft darstellt.

DUMMYUNIONNAME.audioSystemEffectsPropertyChange

Wenn type APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE ist, ist der Union-Wert ein AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION , der eine Benachrichtigung über eine Änderung an einer APO-Systemeffekteigenschaft darstellt.

DUMMYUNIONNAME.audioEndpointVolumeChange2

Wenn type APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2 ist, ist der Union-Wert ein AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2, der eine Benachrichtigung über eine Änderung am APO-Endpunktvolume darstellt, das master und Kanalvolume in dB enthält.

DUMMYUNIONNAME.deviceOrientation

Wenn type APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION ist, ist der Union-Wert ein DEVICE_ORIENTATION_TYPE, der einen Geräteausrichtungswert darstellt.

DUMMYUNIONNAME.audioMicrophoneBoostChange

Wenn type APO_NOTIFICATION_TYPE_MICROPHONE_BOOST ist, ist der Union-Wert ein AUDIO_MICROPHONE_BOOST_NOTIFICATION , der eine APO-Benachrichtigung zur Verstärkung des Endpunktmikrofons darstellt.

DUMMYUNIONNAME.audioEnvironmentChange

Wenn type APO_NOTIFICATION_TYPE_AUDIO_ENVIRONMENT_STATE_CHANGE ist, ist der Union-Wert ein AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION, der eine APO-Benachrichtigung zur Änderung der Audioumgebung darstellt.

Hinweise

Registrieren Sie sich für die Typen von Benachrichtigungen, die Sie erhalten möchten, indem Sie IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo implementieren. Erhalten Sie die registrierten Benachrichtigungen, indem Sie IAudioProcessingObjectNotifications::HandleNotification implementieren.

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