SerCx2CustomReceiveTransactionReportProgress, fonction (sercx.h)

Article
02/26/2024

La méthode SerCx2CustomReceiveTransactionReportProgress indique si la progression est en cours vers l’exécution de la transaction de réception personnalisée actuelle.

Syntaxe

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

Paramètres

CustomReceiveTransaction

Handle SERCX2CUSTOMRECEIVETRANSACTION à un objet de réception personnalisé. Le pilote du contrôleur série a précédemment appelé la méthode SerCx2CustomReceiveTransactionCreate pour créer cet objet.

[in] Progress

Indique si la transaction de réception personnalisée est en cours d’exécution. Définissez ce paramètre sur l’une des constantes d’énumération suivantes :

SERCX2_CUSTOM_RECEIVE_NO_PROGRESS
SERCX2_CUSTOM_RECEIVE_BYTES_TRANSFERRED

Pour plus d’informations sur ces constantes d’énumération, consultez SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS.

Valeur de retour

None

Remarques

Pour déterminer si le contrôleur série progresse dans la réalisation de la transaction de réception personnalisée actuelle, SerCx2 appelle régulièrement la fonction de rappel d’événement EvtSerCx2CustomReceiveTransactionQueryProgress . En réponse à cet appel, le pilote de contrôleur série appelle SerCx2CustomReceiveTransactionReportProgress pour fournir un rapport de progression.

Chaque appel SerCx2CustomReceiveTransactionReportProgress indique si des octets de données ont été transférés dans la transaction de réception personnalisée actuelle depuis l’appel précédent à cette méthode ou le début de la transaction, selon ce qui est le plus récent. Si un ou plusieurs octets ont été transférés, l’appel indique que le contrôleur série progresse. Si aucun octet n’a été transféré, l’appel signale qu’il n’y a aucune progression.

Le pilote du contrôleur série doit appeler cette méthode uniquement en réponse à un appel de SerCx2 à la fonction EvtSerCx2CustomReceiveTransactionQueryProgress .

Pour plus d’informations, consultez Transactions Custom-Receive SerCx2.