Функция 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 |