PUNREGISTER_NOTIFICATION_CALLBACK función de devolución de llamada (hdaudio.h)

Artículo
03/05/2024

La función de devolución de llamada PUNREGISTER_NOTIFICATION_CALLBACK elimina el registro de una rutina de devolución de llamada de notificación registrada previamente por una llamada a RegisterNotificationCallback.

Sintaxis

PUNREGISTER_NOTIFICATION_CALLBACK PunregisterNotificationCallback;

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

Parámetros

_context

Especifica el valor de contexto del miembro Context de la estructura HDAUDIO_BUS_INTERFACE_V3 .

Handle

Identificador que identifica el motor DMA. Este valor de identificador se obtuvo de una llamada anterior a AllocateCaptureDmaEngine o AllocateRenderDmaEngine.

NotificationCallback

Rutina de devolución de llamada que se registró anteriormente para la notificación de progreso de DMA con una llamada a PREGISTER_NOTIFICATION_CALLBACK.

CallbackContext

Valor de contexto específico del controlador para la rutina de devolución de llamada.

Valor devuelto

PUNREGISTER_NOTIFICATION_CALLBACK devuelve STATUS_SUCCESS si la llamada anula correctamente el registro del evento de notificación. De lo contrario, la rutina devuelve STATUS_INVALID_PARAMETER para indicar que la rutina de devolución de llamada y el contexto especificados no son válidos.

Para obtener más información, vea Valores NTSTATUS.

Comentarios

PUNREGISTER_NOTIFICATION_CALLBACK usará NotificationCallback y CallbackContext para buscar la rutina de devolución de llamada registrada previamente que se va a quitar.

El controlador hd Audio Bus liberará la referencia que tomó en el FDO del controlador cuando la rutina de devolución de llamada de notificación se registró anteriormente.