SerCx2CustomReceiveTransactionNewDataNotification, fonction (sercx.h)

La méthode SerCx2CustomReceiveTransactionNewDataNotification avertit la version 2 de l’extension du 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

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

Valeur de retour

None

Remarques

Si le FIFO de réception dans le contrôleur de série devient vide avant qu’une transaction de réception personnalisée puisse être terminée, SerCx2 appelle la fonction de rappel d’événements EvtSerCx2CustomReceiveTransactionEnableNewDataNotification , 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 du 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 de 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’expiration, consultez SERIAL_TIMEOUTS. Pour plus d’informations sur les notifications de nouvelles données, consultez SerCx2 Custom-Receive Transactions.

Configuration requise

   
Client minimal pris en charge Disponible à partir de Windows 8.1.
Plateforme cible Universal
En-tête sercx.h
IRQL <= DISPATCH_LEVEL

Voir aussi

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

IRP_MJ_READ

SERCX2CUSTOMRECEIVETRANSACTION

SERIAL_TIMEOUTS

SerCx2CustomReceiveTransactionCreate