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

Artículo
02/26/2024

La rutina RegisterNotificationEvent registra un evento de kernel para que pueda recibir notificaciones de progreso de DMA.

El tipo de puntero de función para una rutina RegisterNotificationEvent se define como se indica a continuación.

Sintaxis

PREGISTER_NOTIFICATION_EVENT PregisterNotificationEvent;

NTSTATUS PregisterNotificationEvent(
  [in] PVOID _context,
  [in] HANDLE Handle,
  [in] PKEVENT NotificationEvent
)
{...}

Parámetros

[in] _context

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

[in] Handle

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

[in] NotificationEvent

Puntero a un evento de kernel que se debe notificar a medida que avanza DMA. Según el parámetro de recuento de notificaciones que se usa con AllocateDmaBufferWithNotification, el evento registrado se señala una o dos veces cada vez que DMA pasa a través del búfer de audio.

Valor devuelto

RegisterNotificationEvent devuelve STATUS_SUCCESS si la llamada registra correctamente el evento. De lo contrario, la rutina devuelve STATUS_INSUFFICIENT_RESOURCES para indicar que no hay recursos suficientes disponibles para completar la operación.

Comentarios

RegisterNotificationEvent registra un evento de kernel con el controlador de bus de audio HD. El controlador de bus hd audio mantiene una lista de eventos de notificación registrados para cada motor DMA y los indica cada vez que el motor recibe una interrupción del IOC. Los eventos no se registran mediante UnregisterNotificationEvent.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	hdaudio.h (incluye Hdaudio.h)
IRQL	PASSIVE_LEVEL