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


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

[Относится только к KMDF]

Функция обратного вызова события EvtDmaEnablerSelfManagedIoStart драйвера запускает самоуправляемые операции ввода-вывода устройства DMA.

Синтаксис

EVT_WDF_DMA_ENABLER_SELFMANAGED_IO_START EvtWdfDmaEnablerSelfmanagedIoStart;

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

Параметры

[in] DmaEnabler

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

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

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

Комментарии

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

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

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

Требования

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

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

EvtDmaEnablerSelfManagedIoStop

WDF_DMA_ENABLER_CONFIG

WdfDmaEnablerCreate