SerCx2CustomReceiveTransactionNewDataNotification 函数 (sercx.h)

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

语法

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

参数

[in] CustomReceiveTransaction

自定义接收对象的 SERCX2CUSTOMRECEIVETRANSACTION 句柄。 串行控制器驱动程序以前调用 SerCx2CustomReceiveTransactionCreate 方法来创建此对象。

返回值

没有

言论

如果串行控制器中的接收 FIFO 在自定义接收事务完成之前变为空,则 SerCx2 调用 EvtSerCx2CustomReceiveTransactionEnableNewDataNotification 事件回调函数(如果已实现),以便在可从接收 FIFO 中读取新数据时启用新的数据通知。

如果启用了新数据通知并且新数据可供读取,串行控制器驱动程序必须调用 SerCx2CustomReceiveTransactionNewDataNotification 来通知 SerCx2。 当驱动程序检测到已接收数据的一个或多个新字节已准备好由自定义数据传输机制传输或已由此机制传输时,将发生此通知。

串行控制器驱动程序必须仅在响应对 EvtSerCx2CustomReceiveTransactionEnableNewDataNotification 函数的调用时调用 SerCx2CustomReceiveTransactionNewDataNot ification。

如果串行控制器驱动程序支持自定义接收事务的新数据通知,则 SerCx 使用这些通知来检测读取(IRP_MJ_READ)请求的时间间隔超时。 有关间隔超时的详细信息,请参阅 SERIAL_TIMEOUTS。 有关新数据通知的详细信息,请参阅 SerCx2 Custom-Receive 事务

要求

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

另请参阅

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

IRP_MJ_READ

SERCX2CUSTOMRECEIVETRANSACTION

SERIAL_TIMEOUTS

SerCx2CustomReceiveTransactionCreate