Função PcRequestNewPowerState (portcls.h)
A função PcRequestNewPowerState é usada para solicitar um novo estado de energia para o dispositivo. Essa função normalmente não é necessária para drivers de adaptador, mas ocasionalmente pode ser útil para contornar alguns tipos de problemas de hardware.
Sintaxe
PORTCLASSAPI NTSTATUS PcRequestNewPowerState(
[in] PDEVICE_OBJECT pDeviceObject,
[in] DEVICE_POWER_STATE RequestedNewState
);
Parâmetros
[in] pDeviceObject
Ponteiro para o FDO (objeto de dispositivo funcional) do adaptador. Esse parâmetro deve apontar para uma estrutura do sistema do tipo DEVICE_OBJECT.
[in] RequestedNewState
Especifica o estado de energia do dispositivo que está sendo solicitado. Defina esse parâmetro como um dos seguintes valores de enumeração DEVICE_POWER_STATE : PowerDeviceD0, PowerDeviceD1, PowerDeviceD2 ou PowerDeviceD3.
Retornar valor
PcRequestNewPowerState retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, retornará uma mensagem de erro apropriada.
Comentários
Um driver de adaptador pode chamar PcRequestNewPowerState para compensar falhas de design de hardware. Por exemplo, se as funções em um adaptador de áudio não forem mutuamente independentes e precisarem ser desligadas em uma ordem específica, o adaptador poderá chamar PcRequestNewPowerState para garantir que um subdispositivo específico seja desligado primeiro.
O parâmetro RequestedNewState pode ser definido como um dos valores de enumeração DEVICE_POWER_STATE na tabela a seguir.
| Estado de energia | Significado |
|---|---|
| PowerDeviceD0 | Estado de energia total |
| PowerDeviceD1 | O estado de suspensão com a menor latência de energia |
| PowerDeviceD2 | Um estado de suspensão de latência média |
| PowerDeviceD3 | Um estado de hibernação completo e o estado de suspensão com a latência de energia mais longa |
O hardware só pode ser acessado no estado de energia PowerDeviceD0. Em qualquer outro estado, o driver deve armazenar em cache todas as tentativas de acesso de hardware e adiar esses acessos até que o estado PowerDeviceD0 seja restaurado.
Para obter mais informações, consulte Gerenciamento de energia para dispositivos de áudio.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | O driver do sistema PortCls implementa a função PcRequestNewPowerState no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores. |
| Plataforma de Destino | Universal |
| Cabeçalho | portcls.h (inclua Portcls.h) |
| Biblioteca | Portcls.lib |
| IRQL | PASSIVE_LEVEL |