SerCx2CustomReceiveTransactionNewDataNotification, fonction (sercx.h)

Article
10/30/2024

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

Syntaxe

void SerCx2CustomReceiveTransactionNewDataNotification(
  [in] SERCX2CUSTOMRECEIVETRANSACTION CustomReceiveTransaction
);

Paramètres

[in] CustomReceiveTransaction

Handle SERCX2CUSTOMRECEIVETRANSACTION à un objet de réception personnalisé. Le pilote du contrôleur série a précédemment appelé la méthode SerCx2CustomReceiveTransactionCreate pour créer cet objet.

Valeur de retour

Aucun

Remarques

Si le FIFO de réception dans le contrôleur série devient vide avant la fin d’une transaction de réception personnalisée, SerCx2 appelle l'EvtSerCx2CustomReceiveTransactionEnableNewDataNotification fonction de rappel d’événement, si elle est implémentée, pour permettre à une nouvelle notification de données de se produire lorsque de nouvelles données sont disponibles pour être lues à partir de la fonction FIFO de réception.

Si les notifications de nouvelles données sont activées et que de nouvelles données sont disponibles pour être lues, le pilote du contrôleur série doit appeler SerCx2CustomReceiveTransactionNewDataNotification pour notifier SerCx2. Cette notification se produit lorsque le pilote détecte qu’un ou plusieurs nouveaux octets de données reçues sont prêts à être transférés par le mécanisme de transfert de données personnalisé ou ont déjà été transférés par ce mécanisme.

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

Si un pilote de contrôleur série prend en charge les notifications de nouvelles données pour les transactions de réception personnalisées, SerCx utilise ces notifications pour détecter les délais d’attente pendant la gestion des demandes de lecture (IRP_MJ_READ). Pour plus d’informations sur les délais d’attente d’intervalle, consultez SERIAL_TIMEOUTS. Pour plus d’informations sur les notifications de nouvelles données, consultez SerCx2 Custom-Receive Transactions.