функция обратного вызова EVT_WDF_DMA_ENABLER_ENABLE (wdfdmaenabler.h)

  • Статья

[Применяется только к KMDF]

Функция обратного вызова события EvtDmaEnable в драйвере включает возможность DMA устройства после того, как устройство переходит в рабочее (D0) состояние.

Синтаксис

EVT_WDF_DMA_ENABLER_ENABLE EvtWdfDmaEnablerEnable;

NTSTATUS EvtWdfDmaEnablerEnable(
  [in] WDFDMAENABLER DmaEnabler
)
{...}

Параметры

[in] DmaEnabler

Дескриптор объекта включения DMA.

Возвращаемое значение

EvtDmaEnablerEnable должен возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(status) равно TRUE, если не возникает ошибок. В противном случае эта функция обратного вызова должна возвращать значение состояния, для которого NT_SUCCESS(status) равно FALSE.

Комментарии

Чтобы зарегистрировать функцию обратного вызова EvtDmaEnablerEnable , драйвер функции для устройства DMA помещает адрес функции обратного вызова в структуру WDF_DMA_ENABLER_CONFIG , прежде чем драйвер вызовет WdfDmaEnablerCreate.

Дополнительные сведения о функции обратного вызова EvtDmaEnableenable см. в разделе Поддержка управления питанием для устройств DMA.

Функция обратного вызова EvtDmaEnableenable вызывается в irQL = PASSIVE_LEVEL. Не следует делать эту функцию обратного вызова страничной.

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfdmaenabler.h (включая Wdf.h)
IRQL PASSIVE_LEVEL (см. раздел "Примечания")

См. также раздел

EvtDmaEnablerDisable

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate