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。
如果驅動程式已藉由呼叫 WdfDmaTransactionSetChannelConfigurationCallback 和驅動程式後續呼叫 WdfDmaTransactionRelease 來指定 EvtDmaTransactionConfigureDmaChannel 事件回呼函式，則會清除回呼。

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

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

規格需求

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

另請參閱

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease