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 liaison 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’expiration est spécifiée par la demande de compteur XOFF).
- Le pilote du contrôleur série reçoit un nombre de caractères supérieur ou égal à un nombre spécifié par la requête de compteur XOFF.
Code principal
Mémoire tampon d’entrée
Le AssociatedIrp.SystemBuffer pointe vers une structure SERIAL_XOFF_COUNTER allouée au client utilisée pour entrer des informations de compteur XOFF.
Longueur de la mémoire tampon d’entrée
Le 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 série ou sur l’une des valeurs spécifiques aux requêtes suivantes :
STATUS_INVALID_PARAMETER
La valeur de nombre spécifiée pour la requête 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddser.h (include Ntddser.h) |