IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)

Die IOCTL_SERENUM_GET_PORT_NAME Anforderung gibt den Wert des PortName-Eintragswerts (oder Bezeichner) für den RS-232-Port zurück. Siehe Registrierungseinstellungen für ein Plug & Play serielles Gerät.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Eingabepufferlänge

Keine.

Ausgabepuffer

Das AssociatedIrp.SystemBuffer-Element verweist auf einen vom Client zugewiesenen Puffer, den Serenum zum Ausgeben des Portnamens verwendet. Der Portname ist eine Unicode-Zeichenfolge mit NULL-Beendigung.

Länge des Ausgabepuffers

Der Parameter.DeviceIoControl.OutputBufferLength-Member ist auf die Größe eines vom Client zugewiesenen Ausgabepuffers in Bytes festgelegt.

Statusblock

Wenn die Anforderung erfolgreich ist, wird der Informationsmember auf die Größe in Bytes der Unicode-Zeichenfolge mit Null-Beendigung festgelegt, die im Ausgabepuffer des Clients zurückgegeben wird.

Der Statusmember ist auf einen der folgenden Werte festgelegt:

STATUS_BUFFER_TOO_SMALL

Der Ausgabepuffer ist zu klein, um die Portnamenzeichenfolge aufzunehmen.

STATUS_SUCCESS

Die Anforderung wurde erfolgreich abgeschlossen.

STATUS_UNSUCCESSFUL

Fehler beim Öffnen des Registrierungsschlüssels für das Gerät oder Lesen des PortName-Eintragswerts (oder Bezeichner).

Anforderungen

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