SetPowerRequirement

9/8/2008

Essa função notifica Power Manager que um aplicativo possui um requisito de energia dispositivo especificado.

Syntax

HANDLE SetPowerRequirement(
  PVOID pvDevice,
  CEDEVICE_POWER_STATE DeviceState,
  ULONG DeviceFlags,
  PVOID pvSystemState,
  ULONG StateFlags
);

Parameters

• pvDevice
  [no] Especifica o dispositivo. Deve ser um válido LPWSTR Nome dispositivo, por exemplo, " com1: ". O significado é determinado pelo Sinalizadores parâmetro.

• DeviceState
  [no] Especifica o estado de energia mínimo dispositivo a partir de enumeração CEDEVICE_POWER_STATE no qual se manter o dispositivo.

• DeviceFlags
  [no] Bit-ou do seguinte sinalizadores.

  Sinalizador	Descrição
  POWER_FORCE	Indica que o requisito deve ser imposto mesmo durante um sistema suspender.
  POWER_NAME	Especifica o nome do dispositivo cuja energia deve ser mantida no ou acima de DeviceState nível.

• pvSystemState
  [no] Se não definido para NULL, indica que o requisito só deve ser imposto para o nomeado sistema estado de energia.

• StateFlags
  [no] Não utilizados. Definido como zero.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Quando SetPowerRequirement é 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.

Aplicativos e drivers devem sempre versão explicitamente seus requisitos de energia tão logo eles não seja necessário. Power Manager automaticamente libera o requisito se o processo de chamada sai por qualquer motivo antes ReleasePowerRequirement seja chamado.

Se múltiplo SetPowerRequirement chamadas feitas para um único dispositivo, o real energia requisito imposto pelo Power Manager é aquele que consome mais energia. De exemplo, se um aplicativo exigir at least dispositivo energia estado d1 e outro requer pelo menos estado de energia dispositivo D2, Power Manager mantém o dispositivo em ambos.

See Also

Reference

CEDEVICE_POWER_STATE
ReleasePowerRequirement

Other Resources

Power Management Functions