通过

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 指定了 EvtDmaTransactionConfigureDmaChannelChannelchannel 事件回调函数，驱动程序随后调用 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