structure SERIAL_STATUS (ntddser.h)
La structure SERIAL_STATUS contient des informations d’état sur le port série.
Syntaxe
typedef struct _SERIAL_STATUS {
ULONG Errors;
ULONG HoldReasons;
ULONG AmountInInQueue;
ULONG AmountInOutQueue;
BOOLEAN EofReceived;
BOOLEAN WaitForImmediate;
} SERIAL_STATUS, *PSERIAL_STATUS;
Membres
Errors
Ensemble d’indicateurs pour indiquer les erreurs de réception qui se sont produites dans le flux d’entrée. Ce membre est défini sur zéro ou sur l’or au niveau du bit d’un ou plusieurs des bits d’indicateur suivants.
| Nom de l’indicateur | Signification |
|---|---|
| SERIAL_ERROR_QUEUEOVERRUN | La mémoire tampon d’entrée interne du pilote de contrôleur série a été dépassée par les données reçues du flux d’entrée. Soit la mémoire tampon d’entrée soit pleine, soit un caractère a été reçu après le caractère EOF (fin de fichier). |
| SERIAL_ERROR_OVERRUN | Le matériel reçu fiFO a été dépassé par les données reçues du flux d’entrée. |
| SERIAL_ERROR_BREAK | Une condition d’arrêt s’est produite sur la ligne d’entrée. |
| SERIAL_ERROR_PARITY | Une erreur de parité a été détectée dans un octet reçu du flux d’entrée. |
| SERIAL_ERROR_FRAMING | Une erreur de trame a été détectée dans les octets reçus du flux d’entrée. |
Une fois que le pilote du contrôleur série fournit les indicateurs deXXX cumulés SERIAL_ERROR_ pour répondre à une demande de IOCTL_SERIAL_GET_COMMSTATUS, le pilote réinitialise les indicateurs à zéro.
HoldReasons
Ensemble d’indicateurs pour indiquer les raisons pour lesquelles le port série attend actuellement de transmettre des octets au flux de sortie. Ce membre est défini sur zéro ou sur l’or au niveau du bit d’un ou plusieurs des bits d’indicateur suivants.
| Nom de l’indicateur | Signification |
|---|---|
| SERIAL_TX_WAITING_FOR_CTS | En attente du signal CTS (effacer pour envoyer). |
| SERIAL_TX_WAITING_FOR_DSR | En attente du signal DSR (jeu de données prêt). |
| SERIAL_TX_WAITING_FOR_DCD | En attente du signal DCD (support de données détecter). |
| SERIAL_TX_WAITING_FOR_XON | En attente du signal XON (transmettre sur). |
| SERIAL_TX_WAITING_ON_BREAK | Envoi d’un signal d’arrêt (valeur d’espacement). |
| SERIAL_TX_WAITING_XOFF_SENT | Envoi d’un signal XOFF (transmission désactivée). Ce signal marque la fin de la transmission à partir du port série, qui attend ensuite que l’appareil sur l’autre extrémité de la ligne commence à transmettre. L’autre appareil reçoit le signal XOFF transmis en tant que signal XON. |
HoldReasons est égal à zéro si le port série n’a aucune raison d’arrêter la transmission d’octets.
AmountInInQueue
Nombre d’octets de données reçues du port série qui sont actuellement disponibles pour être lus à partir de la mémoire tampon d’entrée.
AmountInOutQueue
Nombre d’octets de transmission de données qui attendent actuellement d’être écrites à partir de la mémoire tampon de sortie vers le port série.
EofReceived
Indique si un caractère EOF (fin de fichier) a été reçu. Ce membre est TRUE si un EOF a été reçu. Sinon, il est FALSE. Le caractère EOF marque la fin du flux d’entrée.
WaitForImmediate
Indique si le port série attend de transmettre un caractère immédiat. Ce membre est TRUE si le port série attend de transmettre un caractère immédiat. Sinon, il est FALSE. La transmission d’un caractère immédiat peut être retardée si un bit d’indicateur autre que SERIAL_TX_WAITING_FOR_XON est défini dans le HoldReasons membre. Pour plus d’informations sur les caractères immédiats, consultez IOCTL_SERIAL_IMMEDIATE_CHAR.
Remarques
Cette structure est utilisée par la requête IOCTL_SERIAL_GET_COMMSTATUS.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddser.h |