SerCx2CustomReceiveTransactionNewDataNotification, fonction (sercx.h)

Article
02/26/2024

La méthode SerCx2CustomReceiveTransactionNewDataNotification notifie la version 2 de l’extension d’infrastructure série (SerCx2) que les données peuvent ê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

None

Remarques

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

Si les notifications de nouvelles données sont activées et que de nouvelles données peuvent être lues, le pilote de 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’expiration d’intervalle pendant la gestion des demandes de lecture (IRP_MJ_READ). Pour plus d’informations sur les délais d’attente, consultez SERIAL_TIMEOUTS. Pour plus d’informations sur les notifications de nouvelles données, consultez Transactions Custom-Receive SerCx2.