Поделиться через


Регистрация устройства в хосте устройства

Вы можете зарегистрировать работающее устройство или не запущенное устройство.

Регистрация запущенного устройства

Устройства регистрируются с помощью интерфейса IUPnPRegistrar. Только администраторы могут зарегистрировать работающие устройства. Чтобы зарегистрировать устройство с запущенным объектом управления устройствами, приложение должно вызвать IUPnPRegistrar::RegisterRunningDevice, передав следующее:

  • Текст описания устройства.
  • Указатель IUnknown на объект управления устройством.
  • Строка инициализации, передаваемая объекту управления устройством в методе IUPnPDeviceControl::Initialize.
  • Расположение каталога ресурсов.
  • Время существования устройства.
  • Параметр идентификатора устройства (параметр OUT), являющийся возвращаемым значением этого вызова; Указатель на идентификатор устройства возвращается в C++.

Регистрация неработающего устройства

По умолчанию только администраторы и интерактивные пользователи могут регистрировать не запущенные устройства. Чтобы зарегистрировать устройство с помощью объекта управления устройства, который не запущен, приложение использует метод IUPnPRegistrar::RegisterDevice.

Чтобы программным способом зарегистрировать устройство с нерабочим объектом управления устройства, приложение должно вызвать IUPnPRegistrar::RegisterDevice и передать следующие параметры:

  • Текст описания устройства.
  • ProgID объекта элемента управления устройства.
  • Строка инициализации, передаваемая методу IUPnPDeviceControl::Initialize объекта управления устройством .
  • Идентификатор контейнера.
  • Расположение каталога ресурсов.
  • Время существования устройства.
  • Параметр идентификатора устройства (параметр OUT), который является возвращаемым значением этого вызова. Указатель на идентификатор устройства возвращается в C++.

Регистрации не запущенных устройств можно настроить для сохранения в системных загрузках (устройства не публикуются на этапе завершения работы). Таким образом, если они настроены таким образом, устройства публикуются и объявляются каждый раз при загрузке компьютера.