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


Метод IMDServiceProvider::EnumDevices (mswmdm.h)

Метод EnumDevices перечисляет установленные физические или программные устройства, которые в настоящее время подключены и известны поставщику услуг.

Синтаксис

HRESULT EnumDevices(
  [out] IMDSPEnumDevice **ppEnumDevice
);

Параметры

[out] ppEnumDevice

Указатель на интерфейс IMDSPEnumDevice . Если поставщик услуг реализует IMDServiceProvider2::CreateDevice, этот перечислитель должен перечислять только устройства, не Plug and Play.

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

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

Этот метод вызывается для поставщиков служб, которые не зарегистрированы как Plug and Play (дополнительные сведения см. в разделах Включение PnP для устройств и Перечисление устройств). Поставщик услуг должен возвращать только перечислитель, который будет перечислять только устройства, которые в настоящее время подключены к компьютеру и поддерживаются поставщиком услуг.

Этот метод будет вызываться только при запуске приложения или при вызове IWMDeviceManager2::Reinitialize.

В настоящее время диспетчер устройств Windows Media не поддерживает возврат установленных устройств.

Поставщик услуг не может оповещать приложение, когда устройства подключаются или отключаются от компьютера. Если устройство Plug and Play подключается или отключается, а приложение реализует IWMDMNotification, диспетчер устройств Windows Media отправит уведомление приложению.

Этот метод должен быть реализован. Он не должен возвращать WMDM_E_NOTSUPPORTED или E_NOTIMPL. Дополнительные сведения см. в разделе Обязательные и необязательные интерфейсы.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

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

Перечисление устройств

Интерфейс IMDServiceProvider