PUNREGISTER_NOTIFICATION_CALLBACK função de retorno de chamada (hdaudio.h)

Artigo
02/26/2024

A função de retorno de chamada PUNREGISTER_NOTIFICATION_CALLBACK exclui o registro de uma rotina de retorno de chamada de notificação que foi registrada anteriormente por uma chamada para RegisterNotificationCallback.

Sintaxe

PUNREGISTER_NOTIFICATION_CALLBACK PunregisterNotificationCallback;

NTSTATUS PunregisterNotificationCallback(
  PVOID _context,
  HANDLE Handle,
  PHDAUDIO_DMA_NOTIFICATION_CALLBACK NotificationCallback,
  PVOID CallbackContext
)
{...}

Parâmetros

_context

Especifica o valor de contexto do membro Context da estrutura HDAUDIO_BUS_INTERFACE_V3 .

Handle

Identificador que identifica o mecanismo de DMA. Esse valor de identificador foi obtido de uma chamada anterior para AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.

NotificationCallback

Uma rotina de retorno de chamada que foi registrada anteriormente para notificação de progresso do AMD com uma chamada para PREGISTER_NOTIFICATION_CALLBACK.

CallbackContext

Valor de contexto específico do driver para a rotina de retorno de chamada.

Retornar valor

PUNREGISTER_NOTIFICATION_CALLBACK retornará STATUS_SUCCESS se a chamada cancelar o registro do evento de notificação com êxito. Caso contrário, a rotina retornará STATUS_INVALID_PARAMETER para indicar que a rotina de retorno de chamada e o contexto especificados não são válidos.

Para obter mais informações, consulte Valores NTSTATUS.

Comentários

PUNREGISTER_NOTIFICATION_CALLBACK usará NotificationCallback e CallbackContext para encontrar a rotina de retorno de chamada registrada anteriormente correspondente a ser removida.

O driver de barramento de áudio HD liberará a referência que recebeu no FDO do driver quando a rotina de retorno de chamada de notificação tiver sido registrada anteriormente.