WdfDmaTransactionWdmGetTransferContext 函式 (wdfdmatransaction.h)

[僅適用於 KMDF]

WdfDmaTransactionWdmGetTransferContext 方法會擷取與 DMA 交易相關聯的 WDM 傳輸內容。

語法

PVOID WdfDmaTransactionWdmGetTransferContext(
  [in] WDFDMATRANSACTION DmaTransaction
);

參數

[in] DmaTransaction

要從中擷取傳輸內容的初始化 DMA 交易物件的句柄。

傳回值

與交易相關聯的 DMA 傳輸內容指標 (PTRANSFER_CONTEXT) 。

備註

當驅動程式建立交易時，會配置交易的 DMA 傳輸內容。

WdfDmaTransactionWdmGetTransferContext 必須與使用 DMA 第 3 版的 DMA 啟用器搭配使用。 若要選取第 3 版，請將 WDF_DMA_ENABLER_CONFIG 的 WdmDmaVersionOverride 成員設定為 3。

您的驅動程式可以使用 DMA 傳輸內容直接呼叫下列 WDM DMA 連結庫例程：

• AllocateAdapterChannelEx
• CancelAdapterChannel
• CancelMappedTransfer
• GetScatterGatherListEx
• BuildScatterGatherListEx

您必須先初始化 DMA 交易，再呼叫 WdfDmaTransactionWdmGetTransferContext。

規格需求

需求	值
最低支援的用戶端	Windows 8
目標平台	Universal
最小 KMDF 版本	1.11
標頭	wdfdmatransaction.h (包含 Wdf.h)
程式庫	Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL	<=DISPATCH_LEVEL
DDI 合規性規則	DriverCreate (kmdf)

另請參閱

WdfDmaTransactionCreate