IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)

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

主要代码

IRP_MJ_DEVICE_CONTROL

输入缓冲区

没有。

输入缓冲区长度

没有。

输出缓冲区

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

输出缓冲区长度

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

状态块

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

状态 成员设置为以下值之一:

STATUS_BUFFER_TOO_SMALL

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

STATUS_SUCCESS

请求成功完成。

STATUS_UNSUCCESSFUL

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

要求

要求 价值
标头 ntddser.h (包括 Ntddser.h)