estrutura APO_NOTIFICATION (audioengineextensionapo.h)

Representa uma notificação para uma alteração em um ponto de extremidade do APO ou efeitos do sistema.

Sintaxe

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;

Membros

type

Um valor da enumeração APO_NOTIFICATION_TYPE especificando o tipo de alteração que a notificação representa.

DUMMYUNIONNAME

DUMMYUNIONNAME.audioEndpointVolumeChange

Quando o tipo é APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME, o valor de união é um AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION que representa uma notificação de uma alteração no volume do ponto de extremidade do APO.

DUMMYUNIONNAME.audioEndpointPropertyChange

Quando o tipo é APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE, o valor de união é um AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION que representa uma notificação de uma alteração em uma propriedade de ponto de extremidade do APO.

DUMMYUNIONNAME.audioSystemEffectsPropertyChange

Quando o tipo é APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE, o valor de união é um AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION que representa uma notificação de uma alteração em uma propriedade de efeito do sistema APO.

DUMMYUNIONNAME.audioEndpointVolumeChange2

Quando o tipo é APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2, o valor de união é um AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 que representa uma notificação de uma alteração no volume do ponto de extremidade do APO que inclui master e volume de canal, no banco de dados.

DUMMYUNIONNAME.deviceOrientation

Quando o tipo é APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION, o valor de união é um DEVICE_ORIENTATION_TYPE que representa um valor de orientação do dispositivo.

DUMMYUNIONNAME.audioMicrophoneBoostChange

Quando o tipo é APO_NOTIFICATION_TYPE_MICROPHONE_BOOST, o valor de união é um AUDIO_MICROPHONE_BOOST_NOTIFICATION que representa uma notificação de APO de aumento de microfone do ponto de extremidade.

DUMMYUNIONNAME.audioEnvironmentChange

Quando o tipo é APO_NOTIFICATION_TYPE_AUDIO_ENVIRONMENT_STATE_CHANGE, o valor de união é um AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION que representa uma notificação APO de alteração de ambiente de áudio.

Comentários

Registre-se para os tipos de notificações que você deseja receber implementando IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo. Receba as notificações registradas implementando IAudioProcessingObjectNotifications::HandleNotification.

Para obter mais informações sobre as APIs de Windows 11 para APOs (Objetos de Processamento de Áudio) que podem ser enviadas com drivers de áudio, consulte APIs Windows 11 para objetos de processamento de áudio.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Build 22000
Cabeçalho	audioengineextensionapo.h