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

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 contextual da estrutura de HDAUDIO_BUS_INTERFACE_V3.

Handle

Identificador que identifica o mecanismo 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 DMA com uma chamada para PREGISTER_NOTIFICATION_CALLBACK.

CallbackContext

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

Valor de retorno

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

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

Observações

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

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

Requisitos

Consulte também

PREGISTER_NOTIFICATION_CALLBACK

HDAUDIO_BUS_INTERFACE_V3

hdaudio.h