IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)
La solicitud IOCTL_SERENUM_GET_PORT_NAME devuelve el valor del valor de entrada PortName (o Identifier) para el puerto RS-232. Consulte Configuración del Registro para un dispositivo serie de Plug and Play.
Código principal
Búfer de entrada
Ninguno.
Longitud del búfer de entrada
Ninguno.
Búfer de salida
El miembro AssociatedIrp.SystemBuffer apunta a un búfer asignado por el cliente que Serenum usa para generar el nombre del puerto. El nombre del puerto es una cadena Unicode terminada en null.
Longitud del búfer de salida
El miembro Parameters.DeviceIoControl.OutputBufferLength se establece en el tamaño en bytes de un búfer de salida asignado por el cliente.
Bloque de estado
Si la solicitud se realiza correctamente, el miembro Information se establece en el tamaño en bytes de la cadena Unicode terminada en null que se devuelve en el búfer de salida del cliente.
El miembro Status se establece en uno de los valores siguientes:
STATUS_BUFFER_TOO_SMALL
El búfer de salida es demasiado pequeño para contener la cadena de nombre del puerto.
STATUS_SUCCESS
La solicitud se completó correctamente.
STATUS_UNSUCCESSFUL
Error al abrir la clave del Registro para el dispositivo o leer el valor de entrada PortName (o Identificador).
Requisitos
| Requisito | Valor |
|---|---|
| Header | ntddser.h (incluya Ntddser.h) |