Compartilhar via

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

  • Artigo

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
Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

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

Confira também

Enumerando dispositivos

IMDServiceProvider Interface