SerCx2CustomReceiveTransactionReportProgress-Funktion (sercx.h)

Artikel
10/30/2024

Die SerCx2CustomReceiveTransactionReportProgress Methode meldet, ob der Fortschritt bei der Durchführung der aktuellen benutzerdefinierten Empfangen-Transaktion erfolgt.

Syntax

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

Parameter

CustomReceiveTransaction

Ein SERCX2CUSTOMRECEIVETRANSACTION Handle für ein benutzerdefiniertes Empfangsobjekt. Der serielle Controllertreiber hat zuvor den SerCx2CustomReceiveTransactionCreate Methode aufgerufen, um dieses Objekt zu erstellen.

[in] Progress

Gibt an, ob fortschritte bei der Durchführung der benutzerdefinierten Empfangstransaktion erzielt werden. Legen Sie diesen Parameter auf eine der folgenden Enumerationskonstanten fest:

SERCX2_CUSTOM_RECEIVE_NO_PROGRESS
SERCX2_CUSTOM_RECEIVE_BYTES_TRANSFERRED

Weitere Informationen zu diesen Enumerationskonstanten finden Sie unter SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS.

Rückgabewert

Nichts

Bemerkungen

Um zu ermitteln, ob der serielle Controller Fortschritte beim Abschließen der aktuellen transaktion für den benutzerdefinierten Empfang ausführt, ruft SerCx2 regelmäßig die EvtSerCx2CustomReceiveTransactionQueryProgress Ereignisrückruffunktion auf. Als Reaktion auf diesen Aufruf ruft der serielle Controllertreiber SerCx2CustomReceiveTransactionReportProgress auf, um einen Statusbericht bereitzustellen.

Jede SerCx2CustomReceiveTransactionReportProgress Aufruf meldet, ob Datenbytes in der aktuellen benutzerdefinierten Empfangen-Transaktion seit dem vorherigen Aufruf dieser Methode oder dem Beginn der Transaktion übertragen wurden, je nachdem, welcher Zeitpunkt aktueller ist. Wenn mindestens ein Byte übertragen wurde, meldet der Anruf, dass der serielle Controller Fortschritte macht. Wenn keine Bytes übertragen wurden, meldet der Anruf, dass kein Fortschritt vorhanden ist.

Der serielle Controllertreiber muss diese Methode nur als Reaktion auf einen Aufruf von SerCx2 an die EvtSerCx2CustomReceiveTransactionQueryProgress Funktion aufrufen.

Weitere Informationen finden Sie unter SerCx2 Custom-Receive Transactions.