次の方法で共有

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 呼び出しの各 は、このメソッドの前回の呼び出し以降、またはトランザクションの開始以降に、現在のカスタム受信トランザクションでデータ バイトが転送されたかどうかを報告します。どちらか新しい方です。 1 つ以上のバイトが転送された場合、呼び出しはシリアル コントローラーが進行していることを報告します。 転送されたバイトがない場合、呼び出しは進行状況がないことを報告します。

シリアル コントローラー ドライバーは、SerCx2 から EvtSerCx2CustomReceiveTransactionQueryProgress 関数への呼び出しに応答する場合にのみ、このメソッドを呼び出す必要があります。

詳細については、「SerCx2 Custom-Receive Transactions」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 8.1以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー sercx.h
IRQL <= DISPATCH_LEVEL

関連項目

EvtSerCx2CustomReceiveTransactionQueryProgress

SERCX2CUSTOMRECEIVETRANSACTION

SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS

SerCx2CustomReceiveTransactionCreate