GetDevicePower

9/8/2008

Essa função retorna o atual estado para um dispositivo energia.

Syntax

DWORD GetDevicePower(
  PVOID pvDevice,
  DWORD dwDeviceFlags,
  PCEDEVICE_POWER_STATE pDeviceState
);

Parameters

• pvDevice
  [no] Especifica o dispositivo. Deve ser um válido LPWSTR Nome dispositivo, por exemplo, " com1: ". Este parâmetro será interpretado de acordo com dwDeviceFlags.

• dwDeviceFlags
  [no] Definido como POWER_NAME ou POWER_FORCE.

  Definir como POWER_NAME para especificar o nome do dispositivo que está solicitando a solicitação de energia.

  Definir como POWER_FORCE para causar Power Manager para emitir um IOCTL_POWER_GET para o dispositivo, rather than retornando o estado de energia internamente em cache para o nomeado dispositivo.

• pDeviceState
  [out] Retorna o estado de energia dispositivo CEDEVICE_POWER_STATE.

Return Value

• ERROR_SUCCESS
  Indica sucesso.

Remarks

Quando GetDevicePower é chamado, qualificar o nome do seu dispositivo com um associado classe. Por exemplo \DSK1 {8DD679CE-8AB4-43 c 8-A14A-EA4963FAA715}: Refere-se a uma potência-gerenciado bloco dispositivo chamado DSK1. Se nenhum qualificação classe está presente, o genérico Power-manageable classe {A32942B7-920 C-486b-B0E6-92A702A99B35} Presume-se.

O estado de energia em cache é igual ao último estado de energia solicitado usando SetDevicePower. Power Manager verifica se o driver oferece suporte ao estado de energia solicitada. Se não, Power Manager mapeia o estado de energia solicitada para um estado de energia que o driver dá suporte. Portanto, o estado de energia em cache pode não corresponder a real energia estado enviado para o driver com IOCTL_POWER_SET. Porque passando POWER_NAME para GetDevicePower Retorna o estado de energia em cache, o que GetDevicePower Recupera não pode ser igual o último estado de energia enviado para o driver usando IOCTL_POWER_SET.

Além das que está sendo chamado pelo usuário codificar, SetDevicePower também é chamado internamente pelo Power Manager. Portanto, GetDevicePower pode retornar o estado de energia última solicitada pelo usuário, ou ele poderá retornar o estado de energia último Power Manager solicitada usando SetDevicePower.

See Also

Reference

CEDEVICE_POWER_STATE
IOCTL_POWER_GET
IOCTL_POWER_SET
SetDevicePower

Other Resources

Power Management Functions