wdfdmatransaction.h 標頭

wdf 會使用此標頭。 如需詳細資訊，請參閱

• Windows 驅動程式架構

wdfdmatransaction.h 包含下列程式設計介面：

函式

WdfDmaTransactionAllocateResources WdfDmaTransactionAllocateResources 方法會保留單一封包或系統模式的 DMA 啟用器，以供獨佔 (和重複) 搭配指定的交易對象使用。
WdfDmaTransactionCancel WdfDmaTransactionCancel 方法會嘗試取消正在等候地圖暫存器配置的 DMA 交易。
WdfDmaTransactionCreate WdfDmaTransactionCreate 方法會建立 DMA 交易。
WdfDmaTransactionDmaCompleted WdfDmaTransactionDmaCompleted 方法會通知架構裝置的 DMA 傳輸作業已完成。
WdfDmaTransactionDmaCompletedFinal WdfDmaTransactionDmaCompletedFinal 方法會通知架構裝置的 DMA 傳輸作業已完成，並提供已完成傳輸的長度。
WdfDmaTransactionDmaCompletedWithLength WdfDmaTransactionDmaCompletedWithLength 方法會通知架構裝置的 DMA 傳輸作業已完成，並提供已完成傳輸的長度。
WdfDmaTransactionExecute WdfDmaTransactionExecute 方法會開始執行指定的 DMA 交易。
WdfDmaTransactionFreeResources WdfDmaTransactionFreeResources 方法會釋放驅動程式先前藉由呼叫 WdfDmaTransactionAllocateResources 所配置的 DMA 資源。
WdfDmaTransactionGetBytesTransferred WdfDmaTransactionGetBytesTransferred 方法會傳回已針對指定 DMA 交易傳輸的位元組總數。
WdfDmaTransactionGetCurrentDmaTransferLength WdfDmaTransactionGetCurrentDmaTransferLength 方法會傳回目前 DMA 傳輸的大小。
WdfDmaTransactionGetDevice WdfDmaTransactionGetDevice 方法會傳回與指定 DMA 交易相關聯的架構裝置物件控制碼。
WdfDmaTransactionGetRequest WdfDmaTransactionGetRequest 方法會擷取與指定 DMA 交易相關聯的架構要求物件的控制碼。
WdfDmaTransactionGetTransferInfo WdfDmaTransactionGetTransferInfo 方法會傳回初始化 DMA 交易所需的對應暫存器和散佈/收集清單專案數目。
WdfDmaTransactionInitialize WdfDmaTransactionInitialize 方法會初始化指定的 DMA 交易。
WdfDmaTransactionInitializeUsingOffset WdfDmaTransactionInitializeUsingOffset 方法會使用位元組位移，將指定的 DMA 交易初始化為 MDL 鏈結。
WdfDmaTransactionInitializeUsingRequest WdfDmaTransactionInitializeUsingRequest 方法會使用指定 I/O 要求的參數，初始化指定的 DMA 交易。
WdfDmaTransactionRelease WdfDmaTransactionRelease 方法會終止指定的 DMA 交易，而不會刪除相關聯的 DMA 交易對象。
WdfDmaTransactionSetChannelConfigurationCallback WdfDmaTransactionSetChannelConfigurationCallback 方法會註冊系統模式 DMA 交易的通道設定事件回呼函式。
WdfDmaTransactionSetDeviceAddressOffset WdfDmaTransactionSetDeviceAddressOffset 方法會指定執行 DMA 作業時，系統 DMA 控制器將存取的暫存器位移。
WdfDmaTransactionSetImmediateExecution WdfDmaTransactionSetImmediateExecution 方法會標示指定的 DMA 交易，以便呼叫 WdfDmaTransactionExecute 和 WdfDmaTransactionAllocateResources 立即起始交易或失敗。
WdfDmaTransactionSetMaximumLength WdfDmaTransactionSetMaximumLength 方法會設定與指定 DMA 交易相關聯的 DMA 傳輸最大長度。
WdfDmaTransactionSetSingleTransferRequirement WdfDmaTransactionSetSingleTransferRequirement 方法會指定 DMA 交易必須在單一傳輸中完成。
WdfDmaTransactionSetTransferCompleteCallback WdfDmaTransactionSetTransferCompleteCallback 方法會註冊系統模式 DMA 交易的傳輸完成事件回呼函式。
WdfDmaTransactionStopSystemTransfer WdfDmaTransactionStopSystemTransfer 方法會嘗試在架構呼叫 EvtProgramDma 之後停止系統模式 DMA 傳輸。
WdfDmaTransactionWdmGetTransferCoNtext WdfDmaTransactionWdmGetTransferCoNtext 方法會擷取與 DMA 交易相關聯的 WDM 傳輸內容。

回呼函式

EVT_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL 驅動程式的 EvtDmaTransactionConfigureDmaChannel 事件回呼函式會設定系統模式 DMA 啟用器的 DMA 配接器。
EVT_WDF_DMA_TRANSACTION_DMA_TRANSFER_COMPLETE 當系統模式控制器完成目前的 DMA 傳輸時，會呼叫驅動程式的 EvtDmaTransactionDmaTransferComplete 事件回呼函式。
EVT_WDF_PROGRAM_DMA 架構型驅動程式的 EvtProgramDma 事件回呼函式會程式設計指定的裝置來執行 DMA 傳輸作業。
EVT_WDF_RESERVE_DMA 當架構有保留資源執行和釋放交易時，會呼叫 EvtReserveDma 事件回呼函式。 保留的資源包括地圖暫存器和 WDM DMA 配接器的鎖定。