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
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) |