共用方式為

WdfDmaTransactionSetChannelConfigurationCallback 函式 （wdfdmatransaction.h）

  • 發行項

[僅適用於 KMDF]

WdfDmaTransactionSetChannelConfigurationCallback 方法會登錄系統模式 DMA 交易的通道設定事件回呼函式。

語法

void WdfDmaTransactionSetChannelConfigurationCallback(
  [in]           WDFDMATRANSACTION                             DmaTransaction,
  [in, optional] PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine,
  [in, optional] PVOID                                         ConfigureContext
);

參數

[in] DmaTransaction

初始化之 DMA 交易物件的句柄，要設定或清除通道組態回呼。

[in, optional] ConfigureRoutine

驅動程式 EvtDmaTransactionConfigureDmaChannel 事件回呼函式的指標，或 NULL 以清除它。

[in, optional] ConfigureContext

緩衝區的指標，其中包含要提供給驅動程式 EvtDmaTransactionConfigureDmaChannel 事件回呼函式或 NULL 的內容。

返回值

沒有

備註

此方法可讓驅動程式在設計系統 DMA 控制器之前自定義配接器組態。

一般而言，從 I/O 佇列事件回呼函式內，驅動程式會依下列順序執行下列步驟：

  1. 呼叫 WdfDmaTransactionInitializeUsingRequest、WdfDmaTransactionInitialize，或 WdfDmaTransactionInitializeUsingOffset 初始化交易物件。
  2. 在交易物件上呼叫 WdfDmaTransactionSetChannelConfigurationCallback。
  3. 呼叫 WdfDmaTransactionExecute。
如果驅動程式已指定 EvtDmaTransactionConfigureDmaChannel 事件回呼函式，請呼叫 WdfDmaTransactionSetChannelConfigurationCallback，而驅動程式隨後會呼叫 WdfDmaTransactionRelease，則會清除回呼。

WdfDmaTransactionSetChannelConfigurationCallback 必須與指定系統模式 DMA 配置檔的 DMA 啟用器搭配使用。

如果您的驅動程式在 Windows 8 之前的作系統上呼叫此方法，架構的驗證程式 回報錯誤。

需求

要求 價值
最低支援的用戶端 Windows 8
目標平臺 普遍
最低 KMDF 版本 1.11
標題 wdfdmatransaction.h （包括 Wdf.h）
程式庫 Wdf01000.sys （請參閱架構連結庫版本控制。）
IRQL <=DISPATCH_LEVEL
DDI 合規性規則 DriverCreate（kmdf）

另請參閱

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease