Partager via

IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS IOCTL (ntddser.h)

  • Article

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)

Voir aussi

IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS