Поделиться через


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

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

Функция обратного вызова события EvtDmaEnablerFill драйвера выделяет буферы DMA устройства.

Синтаксис

EVT_WDF_DMA_ENABLER_FILL EvtWdfDmaEnablerFill;

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

Параметры

[in] DmaEnabler

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

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

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

Комментарии

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

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

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

Требования

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

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

EvtDmaEnablerFlush

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate