Método IMDSPDevice::GetPowerSource (mswmdm.h)
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
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 |