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 は EvtSerCx2CustomReceiveTransactionQueryProgress イベント コールバック関数を定期的に呼び出します。 この呼び出しに応答して、シリアル コントローラー ドライバーは SerCx2CustomReceiveTransactionReportProgresss を呼び出して進行状況レポートを提供します。
各 SerCx2CustomReceiveTransactionReportProgress 呼び出しは、このメソッドの前回の呼び出し以降、またはトランザクションの開始以降に、現在のカスタム受信トランザクションでデータ バイトが転送されたかどうかを報告します。どちらか新しい方です。 1 つ以上のバイトが転送された場合、呼び出しはシリアル コントローラーが進行していることを報告します。 転送されたバイトがない場合、呼び出しは進行状況がないことを報告します。
シリアル コントローラー ドライバーは、SerCx2 から EvtSerCx2CustomReceiveTransactionQueryProgress 関数への呼び出しへの応答でのみ、このメソッドを呼び出す必要があります。
詳細については、「 SerCx2 Custom-Receive トランザクション」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8.1以降で使用できます。 |
対象プラットフォーム | ユニバーサル |
Header | sercx.h |
IRQL | <= DISPATCH_LEVEL |
こちらもご覧ください
EvtSerCx2CustomReceiveTransactionQueryProgress
SERCX2CUSTOMRECEIVETRANSACTION