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