IOCTL_SERIAL_GET_MODEM_CONTROL IOCTL (ntddser.h)
Die IOCTL_SERIAL_GET_MODEM_CONTROL-Anforderung gibt den Wert des Modemsteuerungsregisters im seriellen Controller zurück.
Um das Modemsteuerungsregister festzulegen, kann ein Client eine IOCTL_SERIAL_SET_MODEM_CONTROL-Anforderung verwenden.
Hauptcode
Eingabepuffer
Keine.
Länge des Eingabepuffers
Keine.
Ausgabepuffer
Der AssociatedIrp.SystemBuffer-Member verweist auf einen vom Client zugewiesenen ULONG-Puffer, den der serielle Controllertreiber zum Ausgeben des Werts des Modemsteuerungsregisters verwendet.
Länge des Ausgabepuffers
Das Parameters.DeviceIoControl.OutputBufferLength-Element ist auf die Größe eines ULONG-Elements in Bytes festgelegt.
Statusblock
Wenn die Anforderung erfolgreich ist, wird das Information-Element auf die Größe eines ULONG-Elements in Bytes festgelegt. Andernfalls wird das Information-Element auf 0 (null) festgelegt.
Das Element Status ist auf einen der generischen Statuswerte für Anforderungen der seriellen Gerätesteuerung festgelegt.
Hinweise
Die anforderungen IOCTL_SERIAL_GET_MODEM_CONTROL und IOCTL_SERIAL_SET_MODEM_CONTROL werden hauptsächlich für Hardwaretests verwendet. Für die Modemsteuerungsvorgänge ist kein Standardregisterlayout definiert. Peripherietreiber, die diese IOCTLs verwenden, riskieren, sich von den Hardwarefeatures eines bestimmten seriellen Controllers abhängig zu machen.
Ein Beispiellayout eines Modemsteuerungsregisters finden Sie in der Definition der MCR-Bits (SERIAL_MCR_DTR bis SERIAL_MCR_LOOP) in der Headerdatei Serial.h im Beispiel für serielle Treiber auf GitHub.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ntddser.h (include Ntddser.h) |