Compartilhar via


Método IAudioProcessingObjectNotifications::HandleNotification (audioengineextensionapo.h)

Chamado pelo sistema para notificar os clientes sobre alterações em pontos de extremidade do APO ou efeitos do sistema.

Sintaxe

void HandleNotification(
  APO_NOTIFICATION *apoNotification
);

Parâmetros

apoNotification

Um APO_NOTIFICATION que representa a alteração do APO associada à notificação.

Retornar valor

Nenhum

Comentários

Especifique o conjunto de alterações do APO para o qual esse método é chamado implementando IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo.

Esse método será chamado depois que LockForProcess for chamado e deixará de ser chamado antes de UnlockForProcess. Se houver notificações em andamento, elas poderão ser executadas durante ou após UnlockForProcess. O APO deve lidar com a sincronização nesse caso.

Observação

As APOs devem consultar cada propriedade uma vez para obter seu valor inicial porque o método HandleNotification só é invocado quando qualquer uma das propriedades tiver sido alterada. As exceções a isso são o volume inicial do ponto de extremidade de áudio quando o APO se registra para APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME e o valor de PKEY_AudioEndpoint_Disable_SysFx se o APO se registrar para APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE

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