IOCTL_SERIAL_GET_MODEM_CONTROL IOCTL (ntddser.h)

La requête IOCTL_SERIAL_GET_MODEM_CONTROL retourne la valeur du registre de contrôle du modem dans le contrôleur série.

Pour définir le registre de contrôle du modem, un client peut utiliser une requête IOCTL_SERIAL_SET_MODEM_CONTROL .

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

Le membre AssociatedIrp.SystemBuffer pointe vers une mémoire tampon ULONG allouée par le client que le pilote de contrôleur série utilise pour générer la valeur du registre de contrôle du modem.

Longueur de la mémoire tampon de sortie

Le membre Parameters.DeviceIoControl.OutputBufferLength est défini sur la taille, en octets, d’un ULONG.

Bloc d’état

Si la demande réussit, le membre Information est défini sur la taille, en octets, d’un ULONG. 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.

Remarques

Les requêtes IOCTL_SERIAL_GET_MODEM_CONTROL et IOCTL_SERIAL_SET_MODEM_CONTROL sont principalement utilisées pour les tests matériels. Aucune disposition de registre standard n’est définie pour les opérations de contrôle du modem. Les pilotes périphériques qui utilisent ces IOCTL risquent de se rendre dépendants des fonctionnalités matérielles d’un contrôleur série particulier.

Pour obtenir un exemple de disposition d’un registre de contrôle de modem, consultez la définition des bits MCR (SERIAL_MCR_DTR à SERIAL_MCR_LOOP) dans le fichier d’en-tête Serial.h dans l’exemple de pilote série sur GitHub.

Configuration requise

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

Voir aussi

IOCTL_SERIAL_SET_MODEM_CONTROL