通过

SerCx2CustomReceiveTransactionReportProgress 函数 （sercx.h）

  • 项目

SerCx2CustomReceiveTransactionReportProgress 方法报告是否正在进行完成当前自定义接收事务的进度。

语法

void SerCx2CustomReceiveTransactionReportProgress(
       SERCX2CUSTOMRECEIVETRANSACTION             CustomReceiveTransaction,
  [in] SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS Progress
);

参数

CustomReceiveTransaction

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

[in] Progress

是否正在进行完成自定义接收事务的进度。 将此参数设置为下列枚举常量之一：

  • SERCX2_CUSTOM_RECEIVE_NO_PROGRESS
  • SERCX2_CUSTOM_RECEIVE_BYTES_TRANSFERRED
有关这些枚举常量的详细信息，请参阅 SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS。

返回值

没有

言论

若要确定串行控制器是否在完成当前自定义接收事务方面取得进展，SerCx2 会定期调用 EvtSerCx2CustomReceiveTransactionQueryProgress 事件回调函数。 为了响应此调用，串行控制器驱动程序调用 SerCx2CustomReceiveTransactionReportProgress 以提供进度报告。

每个 SerCx2CustomReceiveTransactionReportProgress 调用报告当前自定义接收事务中是否传输了任何数据字节，因为之前对此方法的调用或事务的开始（以较最近为准）。 如果传输了一个或多个字节，调用将报告串行控制器正在进行。 如果未传输任何字节，则调用将报告没有进度。

串行控制器驱动程序必须仅在响应从 SerCx2 到 EvtSerCx2CustomReceiveTransactionQueryProgress 函数的调用时调用此方法。

有关详细信息，请参阅 SerCx2 Custom-Receive 事务。

要求

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

另请参阅

EvtSerCx2CustomReceiveTransactionQueryProgress

SERCX2CUSTOMRECEIVETRANSACTION

SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS

SerCx2CustomReceiveTransactionCreate