Funzione SerCx2PioReceiveReady (sercx.h)

Articolo
10/30/2024

Il metodo SerCx2PioReceiveReady notifica alla versione 2 dell'estensione del framework seriale (SerCx2) che i dati sono disponibili per essere letti dalla ricezione FIFO nel controller seriale.

Sintassi

void SerCx2PioReceiveReady(
  [in] SERCX2PIORECEIVE PioReceive
);

Parametri

[in] PioReceive

Handle SERCX2PIORECEIVE a un oggetto di ricezione PIO. Il driver del controller seriale precedentemente denominato metodo SerCx2PioReceiveCreate per creare questo oggetto.

Valore restituito

Nessuno

Osservazioni

Per avviare una transazione di ricezione PIO, SerCx2 chiama il EvtSerCx2PioReceiveReadBuffer funzione di callback degli eventi e fornisce un buffer di lettura a cui trasferire i dati dalla ricezione FIFO nel controller seriale. Se il valore restituito da questa funzione indica che il buffer di lettura è stato riempito solo parzialmente prima che la ricezione FIFO sia diventata vuota, SerCx2 chiama il EvtSerCx2PioReceiveEnableReadyNotification routine di callback dell'evento per consentire l'esecuzione di una notifica pronta quando sono disponibili altri dati da leggere.

Se la notifica pronta è abilitata e sono disponibili altri dati da leggere, il driver del controller seriale deve chiamare SerCx2PioReceiveReady per notificare a SerCx2. In risposta a questa notifica, SerCx2 chiama nuovamente la funzione EvtSerCx2PioReceiveReadBuffer per trasferire più dati dalla ricezione FIFO al buffer di lettura.

Il driver del controller seriale deve chiamare SerCx2PioReceiveReady solo in risposta a una chiamata alla funzione EvtSerCx2PioReceiveEnableReadyNotification.

SerCx2 usa inoltre queste notifiche pronte per rilevare i timeout di intervallo durante la gestione di una richiesta di lettura. Per altre informazioni sui timeout degli intervalli, vedere SERIAL_TIMEOUTS. Per altre informazioni sulle notifiche pronte, vedere SerCx2 PIO-Receive Transactions.