struttura APO_NOTIFICATION (audioengineextensionapo.h)

Rappresenta una notifica per una modifica a un endpoint APO o effetti di sistema.

Sintassi

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;

Members

type

Valore dell'enumerazione APO_NOTIFICATION_TYPE che specifica il tipo di modifica rappresentato dalla notifica.

DUMMYUNIONNAME

DUMMYUNIONNAME.audioEndpointVolumeChange

Quando il tipo è APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME, il valore di unione è un AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION che rappresenta una notifica di una modifica al volume dell'endpoint APO.

DUMMYUNIONNAME.audioEndpointPropertyChange

Quando il tipo è APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE, il valore di unione è un AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION che rappresenta una notifica di una modifica a una proprietà dell'endpoint APO.

DUMMYUNIONNAME.audioSystemEffectsPropertyChange

Quando il tipo è APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE, il valore di unione è un AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION che rappresenta una notifica di una modifica a una proprietà dell'effetto di sistema APO.

DUMMYUNIONNAME.audioEndpointVolumeChange2

Quando il tipo è APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2, il valore di unione è un AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 che rappresenta una notifica di una modifica al volume endpoint APO che include il volume master e del canale, in dB.

DUMMYUNIONNAME.deviceOrientation

Quando il tipo è APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION, il valore di unione è un DEVICE_ORIENTATION_TYPE che rappresenta un valore di orientamento del dispositivo.

DUMMYUNIONNAME.audioMicrophoneBoostChange

Quando il tipo è APO_NOTIFICATION_TYPE_MICROPHONE_BOOST, il valore di unione è un AUDIO_MICROPHONE_BOOST_NOTIFICATION che rappresenta una notifica APO di boosting del microfono dell'endpoint.

DUMMYUNIONNAME.audioEnvironmentChange

Quando il tipo è APO_NOTIFICATION_TYPE_AUDIO_ENVIRONMENT_STATE_CHANGE, il valore di unione è un AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION che rappresenta una notifica APO di modifica dell'ambiente audio.

Commenti

Registrarsi per i tipi di notifiche che si desidera ricevere implementando IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo. Ricevere le notifiche registrate implementando IAudioProcessingObjectNotifications::HandleNotification.

Per altre informazioni sulle API di Windows 11 per le API (Audio Processing Objects) che possono essere fornite con driver audio, vedere API Windows 11 per oggetti di elaborazione audio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Build 22000
Intestazione	audioengineextensionapo.h