Função WdfDeviceGetDevicePowerState (wdfdevice.h)
[Aplica-se somente ao KMDF]
Nota
Essa função é somente para uso interno da Microsoft.
O método WdfDeviceGetDevicePowerState retorna o estado atual do computador de estado de energia da estrutura para um dispositivo especificado.
Sintaxe
WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
[in] WDFDEVICE Device
);
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
Valor de retorno
WdfDeviceGetDevicePowerState retorna um enumerador tipo WDF_DEVICE_POWER_STATEque identifica o estado atual do computador de estado de energia da estrutura para o dispositivo especificado.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
Para obter mais informações sobre os computadores de estado da estrutura, consulte State Machines in the Framework.
O método WdfDeviceGetDevicePowerState retornará um valor significativo somente se for chamado de dentro das seguintes funções de retorno de chamada:
Exemplos
O exemplo de código a seguir obtém o estado atual do computador de estado de energia da estrutura para um dispositivo especificado.
WDF_DEVICE_POWER_STATE state;
state = WdfDeviceGetDevicePowerState(Device);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfdevice.h (inclua Wdf.h) |
| biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |