SerCx2SystemDmaReceiveNewDataNotification 函数（sercx.h）

项目
10/30/2024

SerCx2SystemDmaReceiveNewDataNotification 方法通知串行框架扩展版本 2（SerCx2）提供可从串行控制器硬件中的接收 FIFO 读取数据。

语法

void SerCx2SystemDmaReceiveNewDataNotification(
  [in] SERCX2SYSTEMDMARECEIVE SystemDmaReceive
);

参数

[in] SystemDmaReceive

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

返回值

没有

言论

如果串行控制器中的接收 FIFO 在系统-DMA 接收事务完成之前变为空，则 SerCx2 调用 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 事件回调函数（如果已实现），使 SerCx2 能够在数据再次可供从接收 FIFO 读取时接收新的数据通知。

如果启用了新数据通知，串行控制器驱动程序必须调用 SerCx2SystemDmaReceiveNewDataNotification，以便在串行控制器收到新数据后通知 SerCx2。当驱动程序检测到已接收的一个或多个新字节数据已准备好传输或已由系统 DMA 控制器传输时，会发生通知。

串行控制器必须仅在响应对 EvtSerCx2SystemDmaReceiveEnableNewDataNotification 函数的调用时调用 SerCx2SystemDmaReceiveNewDataNotification。

如果串行控制器驱动程序支持系统-DMA 接收事务的新数据通知，则 SerCx 使用这些通知来检测读取（IRP_MJ_READ）请求的时间间隔超时。有关间隔超时的详细信息，请参阅 SERIAL_TIMEOUTS。有关新数据通知的详细信息，请参阅 SerCx2 System-DMA-Receive 事务。