Compartilhar via

Método IMDSPDevice::GetPowerSource (mswmdm.h)

  • Artigo

O método GetPowerSource informa se o dispositivo é capaz de ser executado em baterias, energia externa ou ambos e em que tipo de fonte de energia ele está em execução no momento. Se o dispositivo estiver funcionando com baterias, esse método também relatará a porcentagem de energia total restante nas baterias.

Sintaxe

HRESULT GetPowerSource(
  [out] DWORD *pdwPowerSource,
  [out] DWORD *pdwPercentRemaining
);

Parâmetros

[out] pdwPowerSource

Ponteiro para um DWORD que recebe um valor que indica a fonte de energia atual para o dispositivo. O valor é um dos sinalizadores a seguir.

Sinalizador Descrição
WMDM_POWER_CAP_BATTERY O dispositivo de mídia pode funcionar com baterias.
WMDM_POWER_CAP_EXTERNAL O dispositivo de mídia pode ser executado com energia externa.
WMDM_POWER_IS_BATTERY O dispositivo de mídia está atualmente funcionando em baterias.
WMDM_POWER_IS_EXTERNAL No momento, o dispositivo de mídia está em execução na energia externa.
WMDM_POWER_PERCENT_AVAILABLE O percentual de energia restante foi retornado em pdwPercentRemaining.

[out] pdwPercentRemaining

Se o dispositivo estiver em execução em baterias, pdwPercentRemaining especificará um ponteiro para um DWORD que contém o percentual de energia total restante da bateria.

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 do Windows Media Gerenciador de Dispositivos
Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Somente dispositivos físicos relatam recursos de fonte de energia e fonte de alimentação atual. As implementações de software de dispositivos não relatam recursos de energia nem fonte de energia atual.

Esse método é opcional. 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

IMDSPDevice Interface