EVT_WDF_DMA_ENABLER_FILL función de devolución de llamada (wdfdmaenabler.h)
[Solo se aplica a KMDF]
La función de devolución de llamada de eventos EvtDmaEnablerFill de un controlador asigna los búferes DMA de un dispositivo.
Sintaxis
EVT_WDF_DMA_ENABLER_FILL EvtWdfDmaEnablerFill;
NTSTATUS EvtWdfDmaEnablerFill(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Parámetros
[in] DmaEnabler
Identificador de un objeto enabler de DMA.
Valor devuelto
EvtDmaEnablerFill 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 EvtDmaEnablerFill , 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 EvtDmaEnablerFill , consulte Compatibilidad con la administración de energía para dispositivos DMA.
La función de devolución de llamada EvtDmaEnablerFill se llama 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) |