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

  • Статья

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

Метод WdfDmaTransactionWdmGetTransferContext извлекает контекст передачи WDM, связанный с транзакцией DMA.

Синтаксис

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

Параметры

[in] DmaTransaction

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

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

Указатель на контекст передачи DMA (PTRANSFER_CONTEXT), связанный с транзакцией.

Комментарии

Контекст передачи DMA для транзакции выделяется, когда драйвер создает транзакцию.

WdfDmaTransactionWdmGetTransferContext необходимо использовать с поддержкой DMA, использующим DMA версии 3. Чтобы выбрать версию 3, задайте для элемента WdmDmaVersionOverrideWDF_DMA_ENABLER_CONFIG значение 3.

Драйвер может использовать контекст передачи DMA для непосредственного вызова следующих подпрограмм библиотек WDM DMA:

Необходимо инициализировать транзакцию DMA перед вызовом WdfDmaTransactionWdmGetTransferContext.

Требования

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

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

WdfDmaTransactionCreate