Funzione SerCx2PioReceiveReady (sercx.h)

  • Articolo

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 la funzione di callback dell'evento EvtSerCx2PioReceiveReadBuffer 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 la routine di callback dell'evento EvtSerCx2PioReceiveEnableReadyNotification 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 inviare una notifica a SerCx2. In risposta a questa notifica, SerCx2 chiama nuovamente la funzione EvtSerCx2PioReceiveReadBuffer per trasferire altri 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 degli intervalli durante la gestione di una richiesta di lettura. Per altre informazioni sui timeout di intervallo, vedere SERIAL_TIMEOUTS. Per altre informazioni sulle notifiche pronte, vedere SerCx2 PIO-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

EvtSerCx2PioReceiveReadBuffer

SERCX2PIORECEIVE

SERIAL_TIMEOUTS

SerCx2PioReceiveCreate