EVT_SERCX2_SYSTEM_DMA_RECEIVE_CANCEL_NEW_DATA_NOTIFICATION回调函数 （sercx.h）
EvtSerCx2SystemDmaReceiveCancelNewDataNotification 事件回调函数由串行框架扩展版本 2 （SerCx2） 调用，以取消在对 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 事件回调函数中启用的新数据通知。
语法
EVT_SERCX2_SYSTEM_DMA_RECEIVE_CANCEL_NEW_DATA_NOTIFICATION EvtSercx2SystemDmaReceiveCancelNewDataNotification;
BOOLEAN EvtSercx2SystemDmaReceiveCancelNewDataNotification(
[in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
)
{...}
参数
[in] SystemDmaReceive
系统 DMA 接收对象的 SERCX2SYSTEMDMARECEIVE 句柄。 串行控制器驱动程序以前调用 SerCx2SystemDmaReceiveCreate 方法来创建此对象。
返回值
EvtSerCx2SystemDmaReceiveCancelNewDataNotification 函数返回 TRUE（如果成功取消了新数据通知，并且串行控制器驱动程序可以保证此通知不会导致调用 SerCx2SystemDmaReceiveNewDataNotification 方法）。 如果驱动程序已调用 SerCx2SystemDmaReceiveNewDataNotification 方法或即将调用此方法，该函数将返回 FALSE。
言论
串行控制器驱动程序可以根据需要实现此函数。 如果实现，驱动程序会在 SerCx2SystemDmaReceiveCreate 调用中注册该函数，该调用将创建 system-DMA-receive 对象。 实现此函数的驱动程序还必须实现 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 事件回调函数。
如果关联的读取请求在等待新数据通知请求时超时或取消，则 SerCx2 调用 EvtSerCx2SystemDmaReceiveCancelNewDataNotification 函数取消挂起的通知。 如果此调用返回 FALSE，则 SerCx2 要求串行控制器驱动程序调用 SerCx2SystemDmaReceiveNewDataNotification;只有在此调用之后，SerCx2 才会调用 EvtSerCx2SystemDmaReceiveCleanupTransaction 函数（如果已实现）并完成请求。
若要取消新数据通知，EvtSerCx2SystemDmaReceiveCancelNewDataNotification 函数通常会禁用串行控制器中的中断，指示可从接收 FIFO 读取更多数据。 先前对 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 函数的调用启用了此中断。
有关详细信息，请参阅 SerCx2 System-DMA-Receive 事务。
例子
若要定义 EvtSerCx2SystemDmaReceiveCancelNewDataNotification 回调函数，必须先提供一个函数声明来标识要定义的回调函数的类型。 Windows 为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows 操作系统编写驱动程序的要求。
例如，若要定义名为 的 MySystemDmaReceiveCancelNewDataNotification 回调函数，请使用 EVT_SERCX2_SYSTEM_DMA_RECEIVE_CANCEL_NEW_DATA_NOTIFICATION 函数类型，如以下代码示例所示：
EVT_SERCX2_SYSTEM_DMA_RECEIVE_CANCEL_NEW_DATA_NOTIFICATION MySystemDmaReceiveCancelNewDataNotification;
然后，按如下所示实现回调函数：
_Use_decl_annotations_
BOOLEAN
MySystemDmaReceiveCancelNewDataNotification(
SERCX2SYSTEMDMARECEIVE SystemDmaReceive
)
{...}
EVT_SERCX2_SYSTEM_DMA_RECEIVE_CANCEL_NEW_DATA_NOTIFICATION 函数类型在 Sercx.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 EVT_SERCX2_SYSTEM_DMA_RECEIVE_CANCEL_NEW_DATA_NOTIFICATION 函数类型的批注。 有关函数声明要求的详细信息，请参阅 使用 KMDF 驱动程序的函数角色类型声明函数。 有关 Use_decl_annotations的详细信息，请参阅 批注函数行为。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从Windows 8.1开始可用。 |
| 目标平台 | 桌面 |
| 标头 | sercx.h |
| IRQL | 在 IRQL <调用 = DISPATCH_LEVEL。 |