IOCTL_SERENUM_GET_PORT_NAME - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ntddser.h

// CTL_CODE(0x0037, 0x083, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_SERENUM_GET_PORT_NAME 0x0037020C
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ni-ntddser-ioctl_serenum_get_port_name)

IOCTL_SERENUM_GET_PORT_NAME IOCTL

Description

The IOCTL_SERENUM_GET_PORT_NAME request returns the value of the PortName (or Identifier) entry value for the RS-232 port -- see Registry Settings for a Plug and Play Serial Device.

Parameters

Major code

Input buffer

None.

Input buffer length

None.

Output buffer

The AssociatedIrp.SystemBuffer member points to a client-allocated buffer that Serenum uses to output the port name. The port name is a null-terminated Unicode string.

Output buffer length

The Parameters.DeviceIoControl.OutputBufferLength member is set to the size in bytes of a client-allocated output buffer.

Input/output buffer

Input/output buffer length

Status block

If the request is successful, the Information member is set to the size in bytes of the null-terminated Unicode string that is returned in the client's output buffer.

The Status member is set to one of the following values:

STATUS_BUFFER_TOO_SMALL

The output buffer is too small to hold the port name string.

STATUS_SUCCESS

The request completed successfully.

STATUS_UNSUCCESSFUL

An error occurred when opening the registry key for the device or reading the PortName (or Identifier) entry value.