Funzione WdfDeviceGetDevicePowerPolicyState (wdfdevice.h)

[Si applica solo a KMDF]

Nota

Questa funzione è solo per l'uso interno di Microsoft.

Il metodo WdfDeviceGetDevicePowerPolicyState restituisce lo stato corrente del computer dello stato del criterio di alimentazione del framework, per un dispositivo specificato.

Sintassi

WDF_DEVICE_POWER_POLICY_STATE WdfDeviceGetDevicePowerPolicyState(
  [in] WDFDEVICE Device
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

Valore restituito

WdfDeviceGetDevicePowerPolicyState restituisce un enumeratore WDF_DEVICE_POWER_POLICY_STATE tipizzato che identifica lo stato corrente del computer dello stato del criterio di alimentazione del framework per il dispositivo specificato.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Per altre informazioni sui computer di stato del framework, vedere Computer di stato in Framework.

Il metodo WdfDeviceGetDevicePowerPolicyState restituisce un valore significativo solo se viene chiamato dalle funzioni di callback registrate dal driver quando chiama WdfDeviceInitSetPowerPolicyEventCallbacks.

Esempio

Nell'esempio di codice seguente viene ottenuto lo stato corrente del computer dello stato del criterio di alimentazione del framework per un dispositivo specificato.

WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;

devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (vedere Framework Library Versioning).
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfDevStateNormalize

WdfDeviceGetDevicePnpState

WdfDeviceGetDevicePowerState