Funzione WdfDeviceGetDevicePowerState (wdfdevice.h)
[Si applica solo a KMDF]
Nota
Questa funzione è solo per l'uso interno di Microsoft.
Il metodo WdfDeviceGetDevicePowerState restituisce lo stato corrente della macchina a stati di alimentazione del framework per un dispositivo specificato.
Sintassi
WDF_DEVICE_POWER_STATE WdfDeviceGetDevicePowerState(
[in] WDFDEVICE Device
);
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
Valore restituito
WdfDeviceGetDevicePowerState restituisce un enumeratore WDF_DEVICE_POWER_STATEtipizzato che identifica lo stato corrente della macchina a stati 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 WdfDeviceGetDevicePowerState restituisce un valore significativo solo se viene chiamato dall'interno delle funzioni di callback seguenti:
Esempi
Nell'esempio di codice seguente viene ottenuto lo stato corrente della macchina a stati di alimentazione del framework per un dispositivo specificato.
WDF_DEVICE_POWER_STATE state;
state = WdfDeviceGetDevicePowerState(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) |