IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)
La requête IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS définit un appareil série en mode d’exploitation de base. Le mode d’exploitation de base de la série lit et écrit un octet à la fois et n’utilise pas le contrôle de flux de négociation ou les délais d’attente. Le mode d’opération de base est adapté à une utilisation par un pilote qui utilise un sous-ensemble de l’interface UART 16550. Par exemple, ces pilotes incluent un pilote de souris ou un pilote de pavé graphique pour un matériel plus ancien qui utilise un UART 16450.
La requête IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS retourne les paramètres du mode d’exploitation en cours d’utilisation juste avant la série définit le mode d’opération de base. Un client utilise une demande de IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS pour restaurer un mode d’exploitation précédent. Un client doit traiter les paramètres du mode d’exploitation comme opaques. La série ne vérifie pas les paramètres lorsque les paramètres sont restaurés. Notez également qu’un pilote de remplacement pour Serial 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
Le AssociatedIrp.SystemBuffer pointe vers une structure SERIAL_BASIC_SETTINGS allouée par le client utilisée par serial pour générer la configuration actuelle.
Longueur de la mémoire tampon de sortie
Le Parameters.DeviceIoControl.OutputBufferLength est défini sur la taille, en octets, d’une structure SERIAL_BASIC_SETTINGS.
Bloc d’état
Si la requête réussit, l'Informations membre est défini sur la taille, en octets, de SERIAL_BASIC_SETTINGS. Dans le cas contraire, 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddser.h (include Ntddser.h) |