Método IMiniportWaveRTStreamNotification::RegisterNotificationEvent (portcls.h)

El RegisterNotificationEvent método registra un evento que se va a notificar a la notificación de eventos controlada por DMA.

Sintaxis

NTSTATUS RegisterNotificationEvent(
  [in] PKEVENT NotificationEvent
);

Parámetros

[in] NotificationEvent

Puntero a un evento de kernel (PKEVENT) que se va a registrar para la notificación a medida que avanza DMA.

Valor devuelto

RegisterNotificationEvent devuelve un valor de estado de STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de estado de error adecuado.

Comentarios

El controlador de puerto llama a este método en respuesta a una solicitud de propiedad KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT de un cliente. El controlador de puerto asigna el controlador de eventos en modo de usuario a un puntero de evento de kernel y pasa el puntero en con el parámetro NotificationEvent .

Normalmente, cuando se habilita la notificación de eventos controladas por DMA, el hardware DMA se programa para generar interrupciones de hardware en los puntos de notificación previstos en el búfer de audio cíclico. Cuando la rutina de servicio de interrupción del controlador (ISR) detecta esta interrupción, pone en cola una llamada a procedimiento diferido (DPC). El DPC, a su vez, señala cada evento registrado. Se recomienda usar una construcción try/except alrededor del evento que señala la llamada.

Para obtener más información sobre el comportamiento de la propiedad KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT, vea el KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y en sistemas operativos Windows posteriores.
Plataforma de destino	Universal
Encabezado	portcls.h
IRQL	Nivel pasivo.

Consulte también

IMiniportWaveRTStreamNotification

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY