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

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

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

Синтаксис

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

Параметры

[in] DmaTransaction

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

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

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

Замечания

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

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

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

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• BuildScatterGatherListEx

Требования

См. также

WdfDmaTransactionCreate