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