Функция PcRegisterSubdevice (portcls.h)

  • Статья

Функция PcRegisterSubdevice регистрирует дочерний объект, чтобы сделать его доступным для использования клиентами.

Синтаксис

PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PWSTR          Name,
  [in] PUNKNOWN       Unknown
);

Параметры

[in] DeviceObject

Указатель на объект устройства драйвера адаптера. Это системная структура типа DEVICE_OBJECT.

[in] Name

Указатель на строку Юникода, завершающуюся null, которая указывает имя вложенной части. Строковый буфер, на который указывает параметр Name , должен оставаться действительным в течение времени существования объекта устройства. Строка содержит короткое имя, которое отличает подраздел от любых других вложенных устройств, зарегистрированных на том же устройстве. Каждое подустройство устройства должно иметь уникальное имя.

[in] Unknown

Указатель на интерфейс IPort объекта драйвера порта, привязанного к подсети.

Возвращаемое значение

PcRegisterSubdevice возвращает STATUS_SUCCESS, если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки.

Комментарии

Функция регистрирует экземпляр интерфейса устройства для объекта фильтра, представляющего подсеть на звуковом адаптере. Диспетчер ввода-вывода добавляет строку, указанную параметром Name , к ссылочной строке, используемой для идентификации экземпляра. Измененная ссылочная строка полезна для различения подустройств в звуковом адаптере. Дополнительные сведения о ссылочных строках см. в разделе IoRegisterDeviceInterface.

Дополнительные сведения о роли функции PcRegisterSubdevice в регистрации дочернего устройства см. в разделе Создание подделдела.

Драйвер адаптера может вызвать метод IUnregisterSubdevice::UnregisterSubdevice , чтобы удалить регистрацию физического подключения, которое было зарегистрировано при предыдущем вызове PcRegisterSubdevice. Дополнительные сведения см. в разделе Dynamic Audio Subvices.

Требования

Требование Значение
Минимальная версия клиента Системный драйвер PortCls реализует функцию PcRegisterSubdevice в Microsoft Windows 98/Me, а также в Операционных системах Windows 2000 и более поздних версий.
Целевая платформа Универсальное
Верхняя часть portcls.h (включая Portcls.h)
Библиотека Portcls.lib
IRQL PASSIVE_LEVEL

См. также раздел

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface