Partager via

IOCTL_SERIAL_APPLY_DEFAULT_CONFIGURATION IOCTL (ntddser.h)

  • Article

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 de contrôleur série. Ces paramètres sont obtenus à partir du descripteur de ressources ACPI pour le périphérique de contrôleur série. Pour plus d’informations, consultez la spécification ACPI 5.0.

Code principal

IRP_MJ_DEVICE_CONTROL

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 génériques status pour les demandes de contrôle d’appareil série. Une status 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 les autres demandes de contrôle d’E/S IOCTL_SERIAL_XXX pour configurer explicitement le port série.

Remarques

Le client (application ou pilote de périphérique) 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 débit en bauds, les valeurs de délai d’attente et les indicateurs de contrôle de flux.

Cette durée de vie IOCTL est prise en charge par les versions 1 et 2 de l’extension d’infrastructure série (SerCx et SerCx2). Serial.sys, qui gère les ports série nommés (COM1, COM2, etc.) sur un PC, ne prend pas en charge ce IOCTL.

Si un port série ne prend pas en charge ce IOCTL, le client doit spécifier explicitement les paramètres de connexion pour le port. Autrement dit, le client doit envoyer une demande de IOCTL_SERIAL_SET_BAUD_RATE pour définir le taux de bauds, envoyer une demande de IOCTL_SERIAL_SET_TIMEOUTS pour définir les intervalles d’expiration, et ainsi de suite.

Immédiatement après qu’un client a ouvert un port série, le client doit supposer que le port est configuré dans un état inconnu et non initialisé plutôt que dans un état connu par défaut.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 8.
En-tête ntddser.h (inclure Ntddser.h)

Voir aussi

IOCTL_SERIAL_SET_BAUD_RATE

IOCTL_SERIAL_SET_TIMEOUTS