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