SerCx2PioReceiveReady, fonction (sercx.h)

Article
03/01/2024

La méthode SerCx2PioReceiveReady notifie la version 2 de l’extension d’infrastructure série (SerCx2) que les données sont disponibles pour être lues à partir du FIFO de réception dans le contrôleur série.

Syntaxe

void SerCx2PioReceiveReady(
  [in] SERCX2PIORECEIVE PioReceive
);

Paramètres

[in] PioReceive

Handle SERCX2PIORECEIVE à un objet piO-receive. Le pilote de contrôleur série a précédemment appelé la méthode SerCx2PioReceiveCreate pour créer cet objet.

Valeur de retour

None

Remarques

Pour lancer une transaction PIO-receive, SerCx2 appelle la fonction de rappel d’événement EvtSerCx2PioReceiveReadBuffer et fournit une mémoire tampon de lecture vers laquelle transférer les données du FIFO de réception dans le contrôleur série. Si la valeur de retour de cette fonction indique que la mémoire tampon de lecture n’a été que partiellement remplie avant que le FIFO de réception ne devienne vide, SerCx2 appelle la routine de rappel d’événement EvtSerCx2PioReceiveEnableReadyNotification pour activer une notification prête à se produire lorsque davantage de données sont disponibles pour être lues.

Si la notification prête est activée et que davantage de données sont disponibles pour être lues, le pilote de contrôleur série doit appeler SerCx2PioReceiveReady pour notifier SerCx2. En réponse à cette notification, SerCx2 appelle à nouveau la fonction EvtSerCx2PioReceiveReadBuffer pour transférer davantage de données du FIFO de réception vers la mémoire tampon de lecture.

Le pilote du contrôleur série doit appeler SerCx2PioReceiveReady uniquement en réponse à un appel à la fonction EvtSerCx2PioReceiveEnableReadyNotification .

En outre, SerCx2 utilise ces notifications prêtes pour détecter les délais d’attente d’intervalle pendant la gestion d’une demande de lecture. Pour plus d’informations sur les délais d’attente, consultez SERIAL_TIMEOUTS. Pour plus d’informations sur les notifications prêtes, consultez Transactions PIO-Receive SerCx2.