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 イベント コールバック関数を定期的に呼び出します。 この呼び出しに応答して、シリアル コントローラー ドライバーは SerCx2CustomReceiveTransactionReportProgresss を呼び出して進行状況レポートを提供します。

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

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

詳細については、「 SerCx2 Custom-Receive トランザクション」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 8.1以降で使用できます。
対象プラットフォーム ユニバーサル
Header sercx.h
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

EvtSerCx2CustomReceiveTransactionQueryProgress

SERCX2CUSTOMRECEIVETRANSACTION

SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS

SerCx2CustomReceiveTransactionCreate