EVT_WDF_DMA_ENABLER_ENABLE función de devolución de llamada (wdfdmaenabler.h)
[Solo se aplica a KMDF]
La función de devolución de llamada de eventos EvtDmaEnablerEnable de un controlador habilita la funcionalidad DMA de un dispositivo después de que el dispositivo entre en su estado de funcionamiento (D0).
Sintaxis
EVT_WDF_DMA_ENABLER_ENABLE EvtWdfDmaEnablerEnable;
NTSTATUS EvtWdfDmaEnablerEnable(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Parámetros
[in] DmaEnabler
Identificador de un objeto enabler de DMA.
Valor devuelto
EvtDmaEnablerEnable debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE, si no encuentra ningún error. De lo contrario, esta función de devolución de llamada debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.
Comentarios
Para registrar una función de devolución de llamada EvtDmaEnableEnable , un controlador de función para un dispositivo DMA coloca la dirección de la función de devolución de llamada en una estructura de WDF_DMA_ENABLER_CONFIG antes de que el controlador llame a WdfDmaEnablerCreate.
Para obtener más información sobre la función de devolución de llamada EvtDmaEnableEnable , consulte Compatibilidad con la administración de energía para dispositivos DMA.
Se llama a la función de devolución de llamada EvtDmaEnableEnable en IRQL = PASSIVE_LEVEL. No debe hacer que esta función de devolución de llamada se pueda paginar.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Encabezado | wdfdmaenabler.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL (consulte la sección Comentarios) |