SerCx2CustomReceiveTransactionReportProgress, fonction (sercx.h)

Article
10/30/2024

La méthode SerCx2CustomReceiveTransactionReportProgress indique si la progression est effectuée pour terminer 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 progression est effectuée pour terminer la transaction de réception personnalisée. 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

Aucun

Remarques

Pour déterminer si le contrôleur série progresse vers la fin 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 du contrôleur série appelle SerCx2CustomReceiveTransactionReportProgress pour fournir un rapport de progression.

Chaque 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, le cas échéant plus récent. Si un ou plusieurs octets ont été transférés, l’appel signale que le contrôleur série progresse. Si aucun octet n’a été transféré, l’appel signale qu’il n’y a pas de 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 SerCx2 Custom-Receive Transactions.