SerCx2PioReceiveReady, fonction (sercx.h)
La méthode SerCx2PioReceiveReady informe la version 2 de l’extension de framework série (SerCx2) que les données sont disponibles pour être lues à partir de la fiFO de réception dans le contrôleur série.
Syntaxe
void SerCx2PioReceiveReady(
[in] SERCX2PIORECEIVE PioReceive
);
Paramètres
[in] PioReceive
Handle SERCX2PIORECEIVE à un objet de réception d’authentification unique. Le pilote du contrôleur série a précédemment appelé la méthode SerCx2PioReceiveCreate pour créer cet objet.
Valeur de retour
Aucun
Remarques
Pour lancer une transaction de réception PIO, SerCx2 appelle la fonction de rappel d’événements 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é remplie que partiellement avant que le FIFO de réception ne soit vide, SerCx2 appelle l'EvtSerCx2PioReceiveEnableReadyNotification routine de rappel d’événement pour permettre une notification prête à se produire lorsque d’autres données sont disponibles pour être lues.
Si la notification prête est activée et que d’autres données sont disponibles pour être lues, le pilote du 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.
De plus, SerCx2 utilise ces notifications prêtes pour détecter les délais d’attente pendant la gestion d’une demande de lecture. Pour plus d’informations sur les délais d’attente d’intervalle, consultez SERIAL_TIMEOUTS. Pour plus d’informations sur les notifications prêtes, consultez SerCx2 PIO-Receive Transactions.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8.1. |
| plateforme cible | Universel |
| d’en-tête | sercx.h |
| IRQL | <= DISPATCH_LEVEL |