SerCx2PioTransmitPurgeFifoComplete, fonction (sercx.h)

La méthode SerCx2PioTransmitPurgeFifoComplete notifie la version 2 de l’extension de framework série (SerCx2) que le pilote du contrôleur série a fini de vider les données de la fiFO de transmission dans le matériel du contrôleur série.

Syntaxe

void SerCx2PioTransmitPurgeFifoComplete(
  [in] SERCX2PIOTRANSMIT PioTransmit,
  [in] ULONG             BytesPurged
);

Paramètres

[in] PioTransmit

Handle SERCX2PIOTRANSMIT pour un objet de transmission PIO. Le pilote du contrôleur série a précédemment appelé la méthode SerCx2PioTransmitCreate pour créer cet objet.

[in] BytesPurged

Nombre d’octets de données nonent supprimées par le pilote du contrôleur série à partir de la fiFO de transmission.

Valeur de retour

None

Remarques

SerCx2 appelle la fonction de rappel d’événement EvtSerCx2PioTransmitPurgeFifo , si elle est implémentée, pour mettre fin à la transaction de transmission PIO actuelle. SerCx2 a précédemment lancé cette transaction en réponse à une requête d’écriture (IRP_MJ_WRITE) d’un client. Par exemple, SerCx2 peut appeler cette fonction si le client annule la demande d’écriture en attente ou si la demande d’écriture expire. Pour plus d’informations, consultez Gestion de SerCx2 des demandes de lecture et d’écriture.

En réponse à l’appel de fonction EvtSerCx2PioTransmitPurgeFifo , le pilote ignore d’abord toutes les données qui restent dans la fiFO de transmission ; le pilote doit alors appeler SerCx2PioTransmitPurgeFifoComplete pour notifier SerCx2. SerCx2 attend cette notification et ne termine pas la demande d’écriture tant qu’elle n’est pas avertie.

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

SerCx2 utilise la valeur du paramètre BytesPurged pour déterminer le nombre d’octets transmis avec succès avant le vidage de la fiFO de transmission. SerCx2 exige que ces informations terminent une demande d’écriture qui expire ou une demande d’écriture annulée après qu’un ou plusieurs octets sont transmis.

Pour plus d’informations, consultez SerCx2 PIO-Transmit 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

EvtSerCx2PioTransmitPurgeFifo

IRP_MJ_WRITE

SERCX2PIOTRANSMIT

SERIAL_TIMEOUTS

SerCx2PioTransmitCreate