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 della macchina a stati 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_STATEtipizzato che identifica lo stato corrente della macchina a stati dei criteri di alimentazione del framework per il dispositivo specificato.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni
Per altre informazioni sulle macchine a stati del framework, vedere State Machines in framework.
Il metodo WdfDeviceGetDeviceGetDevicePowerPolicyState restituisce un valore significativo solo se viene chiamato dall'interno delle funzioni di callback registrate dal driver quando chiama WdfDeviceInitSetPowerPolicyEventCallbacks.
Esempi
Nell'esempio di codice seguente viene ottenuto lo stato corrente della macchina a stati dei criteri di alimentazione del framework per un dispositivo specificato.
WDF_DEVICE_POWER_POLICY_STATE devicePowerPolicyState;
devicePowerPolicyState = WdfDeviceGetDevicePowerPolicyState(Device);
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfdevice.h (include Wdf.h) |
| libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |