IOCTL_SERIAL_GET_MODEM_CONTROL IOCTL (ntddser.h)
La requête IOCTL_SERIAL_GET_MODEM_CONTROL retourne la valeur du registre de contrôle modem dans le contrôleur série.
Pour définir le registre du contrôle modem, un client peut utiliser une demande de 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 au client que le pilote du contrôleur série utilise pour générer la valeur du registre de contrôle 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 requête réussit, l'Informations membre est défini sur la taille, en octets, d’un ULONG. Dans le cas contraire, 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 d’inscription standard n’est définie pour les opérations de contrôle de modem. Les pilotes périphériques qui utilisent ces IOCTL risquent de dépendre des fonctionnalités matérielles d’un contrôleur série particulier.
Pour obtenir un exemple de disposition d’un registre de contrôle modem, consultez la définition des bits MCR (SERIAL_MCR_DTR via SERIAL_MCR_LOOP) dans le fichier d’en-tête Serial.h de l’exemple de pilote série sur GitHub.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ntddser.h (include Ntddser.h) |