Функция 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, должен оставаться допустимым в течение времени существования объекта устройства. Строка содержит короткое имя, которое отличает вложенный элемент от любых других вложенных devices, зарегистрированных на том же устройстве. У каждого из вложенных устройств должно быть уникальное имя.

[in] Unknown

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

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

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

Замечания

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

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

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

Требования

См. также

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface