IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)
IOCTL_SERENUM_GET_PORT_NAME请求返回 RS-232 端口的 PortName (或 Identifier) 条目值的值 -- 请参阅 即插即用 串行设备的注册表设置。
主要代码
输入缓冲区
无。
输入缓冲区长度
无。
输出缓冲区
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) |