SerCx2PioReceiveReady 函数 (sercx.h)

项目
08/07/2023

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 函数的调用而调用 SerCx2PioReceiveReady 。

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