Funzione SerCx2CustomReceiveTransactionReportProgress (sercx.h)

  • Articolo

Il metodo SerCx2CustomReceiveTransactionReportProgress indica se l'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 di SERCX2CUSTOMRECEIVETRANSACTION a un oggetto di ricezione personalizzato. Il driver del controller seriale precedentemente denominato il metodo SerCx2CustomReceiveTransactionCreate per creare questo oggetto.

[in] Progress

Indica se l'avanzamento viene eseguito 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 la funzione di callback dell'evento EvtSerCx2CustomReceiveTransactionQueryProgress . In risposta a questa chiamata, il driver del controller seriale chiama SerCx2CustomReceiveTransactionReportProgress per fornire un report sullo stato di avanzamento.

Ogni chiamata SerCx2CustomReceiveTransactionReportProgress indica se i byte di dati sono stati trasferiti nella transazione di ricezione personalizzata corrente a partire 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.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.1.
Piattaforma di destinazione Universale
Intestazione sercx.h
IRQL <= DISPATCH_LEVEL

Vedi anche

EvtSerCx2CustomReceiveTransactionQueryProgress

SERCX2CUSTOMRECEIVETRANSACTION

SERCX2_CUSTOM_RECEIVE_TRANSACTION_PROGRESS

SerCx2CustomReceiveTransactionCreate