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)

Consulte también

EvtDmaEnablerDisable

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate