Funzione SerCx2CustomReceiveTransactionReportProgress (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2CustomReceiveTransactionReportProgress segnala se lo stato di avanzamento viene effettuato verso il completamento della transazione di ricezione personalizzata corrente.

Sintassi

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

Parametri

CustomReceiveTransaction

Handle SERCX2CUSTOMRECEIVETRANSACTION a un oggetto di ricezione personalizzato. Il driver del controller seriale precedentemente denominato SerCx2CustomReceiveTransactionCreate metodo per creare questo oggetto.

[in] Progress

Indica se lo stato è in corso per completare la transazione di ricezione personalizzata. Impostare questo parametro su una delle costanti di enumerazione seguenti:

SERCX2_CUSTOM_RECEIVE_NO_PROGRESS
SERCX2_CUSTOM_RECEIVE_BYTES_TRANSFERRED

Per altre informazioni su queste costanti di enumerazione, vedere SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS.

Valore restituito

Nessuno

Osservazioni

Per determinare se il controller seriale sta procedendo verso il completamento della transazione di ricezione personalizzata corrente, SerCx2 chiama periodicamente il EvtSerCx2CustomReceiveTransactionQueryProgress funzione di callback degli eventi. In risposta a questa chiamata, il driver del controller seriale chiama SerCx2CustomReceiveTransactionReportProgress per fornire un report sullo stato di avanzamento.

Ogni SerCx2CustomReceiveTransactionReportProgress chiamata segnala se nella transazione di ricezione personalizzata corrente sono stati trasferiti byte di dati dalla chiamata precedente a questo metodo o dall'inizio della transazione, a seconda di quale sia più recente. Se uno o più byte sono stati trasferiti, la chiamata segnala che il controller seriale sta effettuando lo stato di avanzamento. Se non sono stati trasferiti byte, la chiamata segnala che non sono presenti progressi.

Il driver del controller seriale deve chiamare questo metodo solo in risposta a una chiamata da SerCx2 alla funzione EvtSerCx2CustomReceiveTransactionQueryProgress.

Per altre informazioni, vedere SerCx2 Custom-Receive Transactions.