SerCx2CustomReceiveTransactionReportProgress 函式（sercx.h）

發行項
10/30/2024

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 Transactions。