Compartilhar via


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)

Consulte também

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerPolicyState