Compartir a través de


Método IMDServiceProvider::EnumDevices (mswmdm.h)

El método EnumDevices enumera los dispositivos físicos o de software instalados que están conectados actualmente y que el proveedor de servicios conoce.

Sintaxis

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

Parámetros

[out] ppEnumDevice

Puntero a una interfaz IMDSPEnumDevice . Si el proveedor de servicios implementa IMDServiceProvider2::CreateDevice, este enumerador solo debe enumerar dispositivos que no son de Plug and Play.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

  • Códigos de error COM estándar
  • Códigos de error de Windows convertidos en valores HRESULT
  • Códigos de error de windows Media Administrador de dispositivos
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Se llama a este método en proveedores de servicios que no están registrados como compatibles con Plug and Play (consulte Habilitación de PnP para dispositivos y enumeración de dispositivos para obtener más información). Un proveedor de servicios debe devolver solo el enumerador, que enumerará solo los dispositivos que están conectados actualmente al equipo y que son compatibles con el proveedor de servicios.

Solo se llamará a este método cuando se inicie una aplicación o cuando la aplicación llame a IWMDeviceManager2::Reinitialize.

En la actualidad, Windows Media Administrador de dispositivos no admite la devolución de dispositivos instalados.

El proveedor de servicios no puede alertar a la aplicación cuando los dispositivos se conecten o desconecten del equipo. Si un dispositivo Plug and Play se conecta o desconecta y una aplicación implementa IWMDMNotification, Windows Media Administrador de dispositivos enviará una notificación a la aplicación.

Este método debe implementarse. No debe devolver WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

Enumeración de dispositivos

Interfaz IMDServiceProvider