IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)
Le code de contrôle IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION configure le port série pour utiliser les paramètres matériels par défaut pour l’appareil du contrôleur série. Ces paramètres sont obtenus à partir du descripteur de ressource ACPI pour l’appareil du contrôleur série. Pour plus d’informations, consultez la spécification ACPI 5.0.
Code principal
Mémoire tampon d’entrée
Aucun.
Longueur de la mémoire tampon d’entrée
Aucun.
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. Un état de STATUS_NOT_IMPLEMENTED indique que le port série ne prend pas en charge une configuration par défaut. Dans ce cas, le client doit utiliser l’autre IOCTL_SERIAL_xxx demandes de contrôle d’E/S pour configurer explicitement le port série.
Remarques
Le client (pilote de périphérique ou d’application) envoie ce IOCTL pour configurer le port série afin d’utiliser un ensemble de paramètres de connexion par défaut. Ces paramètres incluent des paramètres matériels spécifiques à la connexion, tels que le taux de baud, les valeurs de délai d’attente et les indicateurs de contrôle de flux.
Cette IOCTL est prise en charge par les versions 1 et 2 de l’extension de framework série (SerCx et SerCx2). Serial.sys, qui gère les ports série nommés (COM1, COM2, et ainsi de suite) sur un PC, ne prend pas en charge cette IOCTL.
Si un port série ne prend pas en charge cette IOCTL, le client doit spécifier explicitement les paramètres de connexion du port. Autrement dit, le client doit envoyer une demande de IOCTL_SERIAL_SET_BAUD_RATE pour définir le taux de baud, envoyer une demande de IOCTL_SERIAL_SET_TIMEOUTS pour définir les intervalles de délai d’attente, et ainsi de suite.
Immédiatement après l’ouverture d’un port série par un client, le client doit supposer que le port est configuré dans un état inconnu et non initialisé plutôt que dans un état par défaut connu.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Prise en charge à partir de Windows 8. |
d’en-tête | ntddser.h (include Ntddser.h) |