Compartilhar via

Função PcRequestNewPowerState (portcls.h)

  • Artigo

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

Confira também

DEVICE_OBJECT