Função WdfDeviceGetDevicePowerState (wdfdevice.h)

[Aplica-se somente ao KMDF]

Observação

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.

Retornar valor

WdfDeviceGetDevicePowerState retorna um enumerador do tipo WDF_DEVICE_POWER_STATE que identifica o estado atual do computador de estado de energia da estrutura para o dispositivo especificado.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Para obter mais informações sobre os computadores de estado da estrutura, consulte Máquinas de Estado na Estrutura.

O método WdfDeviceGetDevicePowerState retornará um valor significativo somente se for chamado de dentro das seguintes funções de retorno de chamada:

• EvtDevicePrepareHardware

• EvtDeviceReleaseHardware

• EvtDeviceD0Entry

• EvtDeviceD0EntryPostInterruptsEnabled

• EvtDeviceD0Exit

• EvtDeviceD0ExitPreInterruptsDisabled

• EvtDeviceSelfManagedIoInit

• EvtDeviceSelfManagedIoSuspend

• EvtDeviceSelfManagedIoRestart

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
Plataforma de Destino	Universal
Versão mínima do KMDF	1.0
Cabeçalho	wdfdevice.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerPolicyState