EVT_SERCX2_SYSTEM_DMA_RECEIVE_ENABLE_NEW_DATA_NOTIFICATION回调函数（sercx.h）

项目
10/30/2024

EvtSerCx2SystemDmaReceiveEnableNewDataNotification 事件回调函数由串行框架扩展版本 2 （SerCx2）调用，使串行控制器驱动程序能够在串行控制器收到新数据时通知 SerCx2。

语法

EVT_SERCX2_SYSTEM_DMA_RECEIVE_ENABLE_NEW_DATA_NOTIFICATION EvtSercx2SystemDmaReceiveEnableNewDataNotification;

void EvtSercx2SystemDmaReceiveEnableNewDataNotification(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
)
{...}

参数

[in] SystemDmaReceive

系统 DMA 接收对象的 SERCX2SYSTEMDMARECEIVE 句柄。串行控制器驱动程序以前调用 SerCx2SystemDmaReceiveCreate 方法来创建此对象。

返回值

没有

言论

串行控制器驱动程序可以根据需要实现此函数。如果实现，驱动程序会在 SerCx2SystemDmaReceiveCreate 调用中注册该函数，该调用将创建 system-DMA-receive 对象。

调用 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 函数后，为 system-DMA-receive 事务启用新的数据通知，串行控制器驱动程序必须调用 SerCx2SystemDmaReceiveNewDataNotification 方法，以在驱动程序检测到已接收数据的一个或多个字节已准备好传输或已由系统 DMA 控制器传输时通知 SerCx2。

EvtSerCx2SystemDmaReceiveEnableNewDataNotification 函数启用的新数据通知是一次性通知。调用此函数并且串行控制器驱动程序向 SerCx2 发送新的数据通知后，在 SerCx2 再次调用该函数以启用另一个通知之前，不会再发送任何通知。

EvtSerCx2SystemDmaReceiveEnableNewDataNotification 函数通常允许在串行控制器从外围设备接收数据时触发中断。

一次不能挂起多个新数据通知。在 SerCx2 调用 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 函数以启用新数据通知后，SerCx2 不会再次调用此函数，直到控制器驱动程序调用 SerCx2SystemDmaReceiveNewDataNotification。

如果关联的读取请求超时或取消，则可以取消挂起的新数据通知。若要取消系统-DMA 接收事务的新数据通知，SerCx2 调用 EvtSerCx2SystemDmaReceiveCancelNewDataNotification 事件回调函数。实现 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 函数的驱动程序还必须实现 EvtSerCx2SystemDmaReceiveCancelNewDataNotification 函数。

SerCx2 使用新数据通知有效管理在处理作为系统 DMA 接收事务处理的读取请求期间发生的时间间隔超时。

有关详细信息，请参阅 SerCx2 System-DMA-Receive 事务。

例子

若要定义 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 回调函数，必须先提供一个函数声明，用于标识要定义的回调函数的类型。 Windows 为驱动程序提供一组回调函数类型。使用回调函数类型声明函数有助于驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows 操作系统编写驱动程序的要求。

例如，若要定义名为的 MySystemDmaReceiveEnableNewDataNotification 回调函数，请使用 EVT_SERCX2_SYSTEM_DMA_RECEIVE_ENABLE_NEW_DATA_NOTIFICATION 函数类型，如以下代码示例所示：

EVT_SERCX2_SYSTEM_DMA_RECEIVE_ENABLE_NEW_DATA_NOTIFICATION  MySystemDmaReceiveEnableNewDataNotification;

然后，按如下所示实现回调函数：

_Use_decl_annotations_
VOID
  MySystemDmaReceiveEnableNewDataNotification(
    SERCX2SYSTEMDMARECEIVE  SystemDmaReceive
    )
  {...}

EVT_SERCX2_SYSTEM_DMA_RECEIVE_ENABLE_NEW_DATA_NOTIFICATION 函数类型在 Sercx.h 头文件中定义。若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 EVT_SERCX2_SYSTEM_DMA_RECEIVE_ENABLE_NEW_DATA_NOTIFICATION 函数类型的批注。有关函数声明要求的详细信息，请参阅使用 KMDF 驱动程序的函数角色类型声明函数。有关 Use_decl_annotations的详细信息，请参阅批注函数行为。