IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)

IOCTL_SERENUM_GET_PORT_NAME请求返回 RS-232 端口的 PortName (或 Identifier) 条目值的值 -- 请参阅 即插即用 串行设备的注册表设置

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

无。

输入缓冲区长度

无。

输出缓冲区

AssociatedIrp.SystemBuffer 成员指向客户端分配的缓冲区,Serenum 使用该缓冲区输出端口名称。 端口名称是以 null 结尾的 Unicode 字符串。

输出缓冲区长度

Parameters.DeviceIoControl.OutputBufferLength 成员设置为客户端分配的输出缓冲区的大小(以字节为单位)。

状态块

如果请求成功, 则信息 成员将设置为客户端输出缓冲区中返回的以 null 结尾的 Unicode 字符串的大小(以字节为单位)。

Status 成员设置为以下值之一:

STATUS_BUFFER_TOO_SMALL

输出缓冲区太小,无法容纳端口名称字符串。

STATUS_SUCCESS

请求已成功完成。

STATUS_UNSUCCESSFUL

打开设备的注册表项或读取 PortName (或 Identifier) 条目值时出错。

要求

要求
Header ntddser.h (包括 Ntddser.h)