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 必須與指定系統模式 DMA 配置檔的 DMA 啟用器搭配使用。

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

規格需求

另請參閱

EvtDmaTransactionConfigureDmaChannel

WdfDmaTransactionRelease