Compartilhar via


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

O método GetPowerSource recupera informações sobre a fonte de energia e a porcentagem de energia restante para o dispositivo.

Sintaxe

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

Parâmetros

[out] pdwPowerSource

Ponteiro para um DWORD especificando informações sobre a fonte de energia do dispositivo.

Os valores retornados possíveis são um OR bit a bit de um ou mais dos valores 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 pdwPowerSource contiver WMDM_POWER_PERCENT_AVAILABLE, um ponteiro para um DWORD especificando o percentual de energia restante no dispositivo.

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.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IWMDMDevice Interface