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
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) |