IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS IOCTL (ntddser.h)

La demande IOCTL_SERIAL_INTERNAL_RESTORE_SETTINGS restaure le mode de fonctionnement spécifié d’un appareil série. Le mode de fonctionnement spécifié doit être un mode qui a été retourné par une demande de IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS . Les paramètres du mode de fonctionnement doivent être traités comme opaques. La série ne vérifie pas les paramètres lors de la restauration des paramètres. Notez également qu’un remplacement de Serial peut implémenter un autre ensemble de paramètres.

Code principal

IRP_MJ_INTERNAL_DEVICE_CONTROL

Mémoire tampon d'entrée

Le membre AssociatedIrp.SystemBuffer de la structure IRP pointe vers une structure de SERIAL_BASIC_SETTINGS allouée par le client qui est utilisée pour entrer des paramètres de mode d’exploitation. Le client doit utiliser les paramètres retournés par une demande de IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS.

Longueur de la mémoire tampon d’entrée

Le membre Parameters.DeviceIoControl.InputBufferLength de la structure IO_STACK_LOCATION est défini sur la taille, en octets, d’une structure SERIAL_BASIC_SETTINGS.

Mémoire tampon de sortie

Aucun.

Longueur de la mémoire tampon de sortie

Aucun.

Bloc d’état

Si la demande réussit, le membre Information est défini sur la taille, en octets, de SERIAL_BASIC_SETTINGS structure. 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 en série. Si Status est défini sur STATUS_BUFFER_TOO_SMALL, le membre Parameters.DeviceIoControl.InputBufferLength de la structure IO_STACK_LOCATION est inférieur à la taille, en octets, d’une structure SERIAL_BASIC_SETTINGS.

Configuration requise

Condition requise	Valeur
En-tête	ntddser.h (incluez Ntddser.h)

Voir aussi

IOCTL_SERIAL_INTERNAL_BASIC_SETTINGS