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) |