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

IRP_MJ_DEVICE_CONTROL

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)

Weitere Informationen

IOCTL_SERIAL_SET_MODEM_CONTROL