Método IMDServiceProvider::EnumDevices (mswmdm.h)
O método EnumDevices enumera os dispositivos físicos ou de software instalados que estão atualmente anexados e são conhecidos pelo provedor de serviços.
Sintaxe
HRESULT EnumDevices(
[out] IMDSPEnumDevice **ppEnumDevice
);
Parâmetros
[out] ppEnumDevice
Ponteiro para uma interface IMDSPEnumDevice . Se o provedor de serviços implementar IMDServiceProvider2::CreateDevice, esse enumerador deverá enumerar apenas dispositivos não Plug and Play.
Retornar valor
O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:
- Códigos de erro COM padrão
- Códigos de erro do Windows convertidos em valores HRESULT
- Códigos de erro de Gerenciador de Dispositivos do Windows Media
Comentários
Esse método é chamado em provedores de serviços que não estão registrados como Plug and Play cientes (consulte Habilitando pnp para dispositivos e enumerando dispositivos para obter detalhes). Um provedor de serviços deve retornar apenas o enumerador, que enumerará apenas os dispositivos que estão atualmente anexados ao computador e têm suporte do provedor de serviços.
Esse método será chamado somente quando um aplicativo for iniciado ou quando o aplicativo chamar IWMDeviceManager2::Reinitialize.
No momento, o Windows Media Gerenciador de Dispositivos não dá suporte ao retorno de dispositivos instalados.
O provedor de serviços não pode alertar o aplicativo quando os dispositivos se conectam ou se desconectam do computador. Se um dispositivo Plug and Play se conectar ou desconectar e um aplicativo implementar IWMDMNotification, o Gerenciador de Dispositivos do Windows Media enviará uma notificação ao aplicativo.
Esse método deve ser implementado. Ele não deve retornar WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |