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 pode ocasionalmente 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, PowerDeviceD2ou PowerDeviceD3.
Valor de retorno
PcRequestNewPowerState retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, retornará uma mensagem de erro apropriada.
Observações
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 subdevice 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 do sono 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 qualquer tentativa de acesso de hardware e adiar esses acessos até que o PowerDeviceD0 estado seja restaurado.
Para obter mais informações, consulte Gerenciamento de Energia para Dispositivos de Áudio.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O driver do sistema PortCls implementa a função PcRequestNewPowerState no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores. |
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h (inclua Portcls.h) |
| biblioteca | Portcls.lib |
| IRQL | PASSIVE_LEVEL |