EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL回调函数 （sercx.h）
EvtSerCx2SystemDmaTransmitConfigureDmaChannel 事件回调函数由串行框架扩展 （SerCx2） 版本 2 调用，以允许串行控制器驱动程序执行在系统-DMA 传输事务中每个 DMA 传输开始之前可能需要的 DMA 适配器的任何自定义配置。
语法
EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL EvtSercx2SystemDmaTransmitConfigureDmaChannel;
NTSTATUS EvtSercx2SystemDmaTransmitConfigureDmaChannel(
[in] SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit,
[in] PMDL Mdl,
[in] ULONG Offset,
[in] ULONG Length
)
{...}
参数
[in] SystemDmaTransmit
系统-DMA 传输对象的 SERCX2SYSTEMDMATRANSMIT 句柄。 串行控制器驱动程序以前调用 SerCx2SystemDmaTransmitCreate 方法来创建此对象。
[in] Mdl
指向 MDL 的指针，该指针描述由系统-DMA 传输事务的写入缓冲区跨越的内存页。 DMA 传输的散点/收集列表将使用由 偏移量 和 长度 参数指定的此内存区域。
[in] Offset
数据传输的起始偏移量。 此参数是 MDL 描述的缓冲区区域的开头的字节偏移量。 如果 MDL 指定缓冲区空间的总 N 个字节，则 偏移量 的可能值介于 0 到 N–1 之间。
[in] Length
数据传输的大小（以字节为单位）。 如果 MDL 指定缓冲区空间的总 N 个字节，则 长度 的可能值在 1 到 N 到 N-偏移量范围内。
返回值
如果调用成功，EvtSerCx2SystemDmaTransmitConfigureDmaChannel 函数返回STATUS_SUCCESS。 否则，它将返回适当的错误状态代码。
言论
串行控制器驱动程序可以根据需要实现此函数。 如果实现，驱动程序会在 SerCx2SystemDmaTransmitCreate 调用中注册该函数，该调用将创建 system-DMA-transmit 对象。
在启动系统-DMA 传输事务之前，SerCx2 调用 EvtSerCx2SystemDmaTransmitConfigureDmaChannel 函数（如果实现）。 此函数执行在 SerCx2 启动 system-DMA 传输事务之前可能需要的系统 DMA 控制器的任何特殊配置。
串行控制器驱动程序可以调用 SerCx2SystemDmaTransmitGetDmaEnabler 等方法，以获取用于系统-DMA 传输事务的系统 DMA 控制器的 DMA 启用器。
有关详细信息，请参阅 SerCx2 System-DMA-Transmit 事务。
例子
若要定义 EvtSerCx2SystemDmaTransmitConfigureDmaChannel 回调函数，必须先提供一个函数声明，用于标识要定义的回调函数的类型。 Windows 为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows 操作系统编写驱动程序的要求。
例如，若要定义名为 的 MySystemDmaTransmitConfigureDmaChannel 回调函数，请使用 EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL 函数类型，如以下代码示例所示：
EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL MySystemDmaTransmitConfigureDmaChannel;
然后，按如下所示实现回调函数：
_Use_decl_annotations_
NTSTATUS
MySystemDmaTransmitConfigureDmaChannel(
SERCX2SYSTEMDMATRANSMIT SystemDmaTransmit,
PMDL Mdl,
ULONG Offset,
ULONG Length
)
{...}
EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL 函数类型在 Sercx.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 EVT_SERCX2_SYSTEM_DMA_TRANSMIT_CONFIGURE_DMA_CHANNEL 函数类型的批注。 有关函数声明要求的详细信息，请参阅 使用 KMDF 驱动程序的函数角色类型声明函数。 有关 Use_decl_annotations的详细信息，请参阅 批注函数行为。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从Windows 8.1开始可用。 |
| 目标平台 | 桌面 |
| 标头 | sercx.h |
| IRQL | 在 IRQL <调用 = DISPATCH_LEVEL。 |