Функция WdfDmaTransactionSetChannelConfigurationCallback (wdfdmatransaction.h)

Статья
02/27/2024

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

Метод WdfDmaTransactionSetChannelConfigurationCallback регистрирует функцию обратного вызова события конфигурации канала для транзакции DMA в системном режиме.

Синтаксис

void WdfDmaTransactionSetChannelConfigurationCallback(
  [in]           WDFDMATRANSACTION                             DmaTransaction,
  [in, optional] PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine,
  [in, optional] PVOID                                         ConfigureContext
);

Параметры

[in] DmaTransaction

Дескриптор инициализированного объекта транзакции DMA, для которого необходимо задать или очистить обратный вызов конфигурации канала.

[in, optional] ConfigureRoutine

Указатель на функцию обратного вызова события EvtDmaTransactionConfigureDmaChannel драйвера или значение NULL для ее очистки.

[in, optional] ConfigureContext

Указатель на буфер, содержащий контекст для функции обратного вызова события EvtDmaTransactionConfigureDmaChannel драйвера или NULL.

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

None

Remarks

Этот метод позволяет драйверу настраивать конфигурацию адаптера перед программированием контроллера DMA системы.

Как правило, из функции обратного вызова событий очереди ввода-вывода драйвер выполняет следующие действия в следующем порядке:

Вызывает WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize или WdfDmaTransactionInitializeUsingOffset для инициализации объекта транзакции.
Вызывает WdfDmaTransactionSetChannelConfigurationCallback для объекта транзакции.
Вызывает WdfDmaTransactionExecute.

Если драйвер указал функцию обратного вызова события EvtDmaTransactionConfigureDmaChannel путем вызова WdfDmaTransactionSetChannelConfigurationCallback и драйвер впоследствии вызывает WdfDmaTransactionRelease, обратный вызов очищается.

WdfDmaTransactionSetChannelConfigurationCallback необходимо использовать с включенной функцией DMA, задающей профиль DMA в системном режиме.

Если драйвер вызывает этот метод в операционной системе раньше, чем Windows 8, средство проверки платформы сообщает об ошибке.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Целевая платформа	Универсальное
Минимальная версия KMDF	1.11
Верхняя часть	wdfdmatransaction.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL	<=DISPATCH_LEVEL
Правила соответствия DDI	DriverCreate(kmdf)

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

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease

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