Freigeben über


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

Nichts.

Eingabepufferlänge

Nichts.

Ausgabepuffer

Der AssociatedIrp.SystemBuffer Member verweist auf einen vom Client zugewiesenen ULONG-Puffer, den der serielle Controllertreiber verwendet, um den Wert des Modemsteuerungsregisters auszugeben.

Länge des Ausgabepuffers

Der Parameters.DeviceIoControl.OutputBufferLength Member wird auf die Größe eines ULONG-Elements in Bytes festgelegt.

Statusblock

Wenn die Anforderung erfolgreich ist, wird der Information Member auf die Größe eines ULONG-Elements in Bytes festgelegt. Andernfalls wird der Information Member auf Null festgelegt.

Der Status- Member ist auf einen der generischen Statuswerte für anforderungen für serielle Gerätesteuerungfestgelegt.

Bemerkungen

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 selbst abhängig von den Hardwarefeatures eines bestimmten seriellen Controllers.

Ein Beispiellayout eines Modemsteuerungsregisters finden Sie in der Headerdatei "Serial.h" in der Headerdatei "Serial.h" im Beispiel für serielle Treiber auf GitHub in der Definition der MCR-Bits (SERIAL_MCR_DTR bis SERIAL_MCR_LOOP).

Anforderungen

Anforderung Wert
Header- ntddser.h (include Ntddser.h)

Siehe auch

IOCTL_SERIAL_SET_MODEM_CONTROL