SetDevicePower
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função define o estado de energia dispositivo para um dispositivo.
Syntax
DWORD SetDevicePower(
PVOID pvDevice,
DWORD dwDeviceFlags,
CEDEVICE_POWER_STATE DeviceState
);
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] Definir como POWER_NAME para especificar o nome do dispositivo que está solicitando a solicitação de energia.
- DeviceState
[no] Especifica o estado de energia dispositivo desejado.
Return Value
ERROR_ACCESS_DENIED
For Windows Embedded CE: Indica que o chamador não é trusted.For Windows Mobile: Indica que o chamador não tem o exigido Privilégios.
- ERROR_FILE_NOT_FOUND
Indica que o dispositivo não foi encontrado.
- ERROR_INVALID_PARAMETER
Indica um inválido dispositivo identificação, sinalizador, ou dwState valor.
- ERROR_SUCCESS
Indica que o dispositivo foi encontrado e estado de energia dispositivo atualizado corretamente.
- ERROR_WRITE_FAULT
Indica que a tentativa atualização a falha de energia dispositivo.
Remarks
Quando SetDevicePower é 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.
Se você especificar um estado de energia que não seja o Power Manager, com suporte irá definir o dispositivo para o próximo maior com suporte energia nível, onde D0 é um nível mais alto que ambos. No entanto, se você especificar D3, o Power Manager será definido o dispositivo para D4, se for D4 com suporte. Caso contrário, o dispositivo é definido para o próximo maior com suporte energia nível.
Aplicativos Evite usar essa função, pois ele restringe consideravelmente dispositivo energia Self-Management. Eles devem usar o SetPowerRequirement chamar em vez disso. Defina o estado de energia dispositivo como PwrDeviceUnspecified Para permitir gerenciamento de energia normal para continuar.