SerCx2PioReceiveReady 函数 (sercx.h)

SerCx2PioReceiveReady 方法通知串行框架扩展版本 2(SerCx2)提供可从串行控制器中的接收 FIFO 读取数据。

语法

void SerCx2PioReceiveReady(
  [in] SERCX2PIORECEIVE PioReceive
);

参数

[in] PioReceive

PIO 接收对象的 SERCX2PIORECEIVE 句柄。 串行控制器驱动程序以前调用 SerCx2PioReceiveCreate 方法来创建此对象。

返回值

没有

言论

为了启动 PIO 接收事务,SerCx2 调用 EvtSerCx2PioReceiveReadBuffer 事件回调函数,并提供从串行控制器中的接收 FIFO 传输数据的读取缓冲区。 如果此函数的返回值指示仅在接收 FIFO 为空之前部分填充读取缓冲区,则 SerCx2 将调用 EvtSerCx2PioReceiveEnableReadyNotification 事件回调例程,以便在更多数据可供读取时启用就绪通知。

如果已启用就绪通知并且有更多数据可供读取,串行控制器驱动程序必须调用 SerCx2PioReceiveReady 以通知 SerCx2。 为了响应此通知,SerCx2 再次调用 EvtSerCx2PioReceiveReadBuffer 函数,以将接收 FIFO 中的更多数据传输到读取缓冲区。

串行控制器驱动程序必须仅在响应对 EvtSerCx2PioReceiveEnableReadyNotification 函数的调用时调用 SerCx2PioReceiveReadyNotification

此外,SerCx2 使用这些就绪通知来检测读取请求的处理期间的时间间隔超时。 有关间隔超时的详细信息,请参阅 SERIAL_TIMEOUTS。 有关就绪通知的详细信息,请参阅 SerCx2 PIO-Receive 事务

要求

要求 价值
最低支持的客户端 从Windows 8.1开始可用。
目标平台 普遍
标头 sercx.h
IRQL <= DISPATCH_LEVEL

另请参阅

EvtSerCx2PioReceiveReadBuffer

SERCX2PIORECEIVE

SERIAL_TIMEOUTS

SerCx2PioReceiveCreate