Funzione WdfDevStateIsNP (wdfdevice.h)
[Si applica a KMDF e UMDF]
Il metodo WdfDevStateIsNP restituisce un valore booleano che indica se uno stato di alimentazione o un criterio di alimentazione specificato è uno stato non impaginabile .
Sintassi
BOOLEAN WdfDevStateIsNP(
[in] ULONG State
);
Parametri
[in] State
Enumeratore tipizzato WDF_DEVICE_POWER_STATE o enumeratore tipizzato WDF_DEVICE_POWER_POLICY_STATE.
Valore restituito
Se il driver chiamante non è attualmente modificabile, il metodo WdfDevStateIsNP restituisce TRUE. In caso contrario, il metodo restituisce FALSE.
Commenti
Per ottenere lo stato corrente della macchina a stati di alimentazione del framework, un driver può chiamare WdfDeviceGetDevicePowerState dall'interno di una funzione di callback di alimentazione o PnP. Per ottenere lo stato corrente della macchina a stati dei criteri di alimentazione del framework, un driver può chiamare WdfDeviceGetDevicePowerPolicyState dall'interno di una funzione di callback dei criteri di alimentazione. Dopo che il driver ha chiamato WdfDeviceGetDevicePowerState o WdfDeviceGetDevicePowerPolicyState, può chiamare WdfDevStateIsNP per determinare se lo stato restituito rappresenta uno stato di paging o non di paging. Se la macchina a stati del framework si trova in uno stato non impaginabile, il driver non è impaginabile e non deve eseguire alcuna operazione che potrebbe causare l'accesso al file di paging da parte del sistema operativo. Tali operazioni includono l'accesso ai file, al Registro di sistema o al pool di paging.
Esempio
Nell'esempio di codice seguente il valore non impaginabile viene impostato su TRUE se la macchina a stati di alimentazione del framework è attualmente in uno stato non impaginabile.
BOOLEAN nonpageable;
nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfdevice.h (include Wdf.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | Qualsiasi livello |