IOCTL_SERIAL_XOFF_COUNTER IOCTL (ntddser.h)
La requête IOCTL_SERIAL_XOFF_COUNTER définit un compteur XOFF. Une demande de compteur XOFF prend en charge les clients qui utilisent des logiciels pour émuler le contrôle de flux de négociation matérielle.
Une demande de compteur XOFF est synchronisée avec les demandes d’écriture. Le pilote envoie un caractère XOFF spécifié et termine la requête après l’un des événements suivants :
- Une demande d’écriture est reçue.
- Un minuteur expire (une valeur de délai d’attente est spécifiée par la demande de compteur XOFF).
- Le pilote de contrôleur série reçoit un nombre de caractères supérieur ou égal à un nombre spécifié par la demande de compteur XOFF.
Code principal
Mémoire tampon d'entrée
AssociatedIrp.SystemBuffer pointe vers une structure de SERIAL_XOFF_COUNTER allouée par le client qui est utilisée pour entrer des informations de compteur XOFF.
Longueur de la mémoire tampon d’entrée
Parameters.DeviceIoControl.InputBufferLength est défini sur la taille, en octets, d’une structure SERIAL_XOFF_COUNTER.
Mémoire tampon de sortie
Aucun.
Longueur de la mémoire tampon de sortie
Aucun.
Bloc d’état
Le membre Information est défini sur zéro.
Le membre Status est défini sur l’une des valeurs d’état génériques pour les demandes de contrôle d’appareil en série ou sur l’une des valeurs suivantes spécifiques à la requête :
STATUS_INVALID_PARAMETER
La valeur de nombre spécifiée pour la demande de compteur XOFF est inférieure à zéro.
STATUS_SERIAL_COUNTER_TIMEOUT
La demande a expiré.
STATUS_SERIAL_MORE_WRITES
Une demande d’écriture a été reçue.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntddser.h (incluez Ntddser.h) |