IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)
La requête IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS définit un appareil série sur un mode de fonctionnement de base. Le mode de fonctionnement de base de série lit et écrit un octet à la fois, et n’utilise pas de contrôle de flux de négociation ou de délais d’expiration. Le mode d’opération de base convient à un pilote qui utilise un sous-ensemble de l’interface UART 16550. Parmi les exemples de tels pilotes, citons un pilote de souris ou un pilote de pavé graphique pour le matériel plus ancien qui utilise un UART 16450.
La requête IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS retourne les paramètres de mode de fonctionnement qui sont en cours d’utilisation juste avant que Serial ne définisse le mode d’opération de base. Un client utilise une demande de IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS pour restaurer un mode de fonctionnement précédent. Un client doit traiter les paramètres du mode de fonctionnement comme opaques. Série ne vérifie pas les paramètres lorsque les paramètres sont restaurés. Notez également qu’un pilote de remplacement pour Série peut implémenter un autre ensemble de paramètres de base.
Code principal
IRP_MJ_INTERNAL_DEVICE_CONTROL
Mémoire tampon d'entrée
Aucun.
Longueur de la mémoire tampon d’entrée
Aucun.
Mémoire tampon de sortie
AssociatedIrp.SystemBuffer pointe vers une structure de SERIAL_BASIC_SETTINGS allouée par le client que Serial utilise pour générer la configuration actuelle.
Longueur de la mémoire tampon de sortie
Parameters.DeviceIoControl.OutputBufferLength est défini sur la taille, en octets, d’une structure SERIAL_BASIC_SETTINGS.
Bloc d’état
Si la demande réussit, le membre Information est défini sur la taille, en octets, de SERIAL_BASIC_SETTINGS. Sinon, 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. Si Status est défini sur STATUS_BUFFER_TOO_SMALL, la valeur de Parameters.DeviceIoControl.OutputLength est inférieure à la taille, en octets, d’une structure SERIAL_BASIC_SETTINGS.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntddser.h (inclure Ntddser.h) |