IOCTL_SERENUM_GET_PORT_NAME IOCTL (ntddser.h)
Запрос IOCTL_SERENUM_GET_PORT_NAME возвращает значение записи PortName (или Идентификатор) для порта RS-232 . См. раздел Параметры реестра для Plug and Play последовательного устройства.
Основной код
Входной буфер
Нет.
Длина входного буфера
Нет.
Выходной буфер
Элемент AssociatedIrp.SystemBuffer указывает на буфер, выделенный клиентом, который Serenum использует для вывода имени порта. Имя порта является строкой Юникода, заканчивающейся null.
Длина выходного буфера
Член Parameters.DeviceIoControl.OutputBufferLength имеет размер в байтах выделенного клиентом выходного буфера.
Блок состояния
Если запрос выполнен успешно, элементу Information присваивается размер строки Юникода, завершаемой null, в байтах, возвращаемой в выходном буфере клиента.
Для элемента Status задано одно из следующих значений:
STATUS_BUFFER_TOO_SMALL
Выходной буфер слишком мал, чтобы вместить строку имени порта.
STATUS_SUCCESS
Запрос успешно выполнен.
STATUS_UNSUCCESSFUL
Ошибка при открытии раздела реестра для устройства или чтении значения записи PortName (или Идентификатора).
Требования
| Требование | Значение |
|---|---|
| Заголовок | ntddser.h (включая Ntddser.h) |