WdfDevStateIsNP, fonction (wdfdevice.h)
[S’applique à KMDF et UMDF]
La méthode WdfDevStateIsNP retourne une valeur booléenne qui indique si un état d’alimentation ou un état de stratégie d’alimentation spécifié est un état non paginable .
Syntaxe
BOOLEAN WdfDevStateIsNP(
[in] ULONG State
);
Paramètres
[in] State
Énumérateur de type WDF_DEVICE_POWER_STATE ou énumérateur de type WDF_DEVICE_POWER_POLICY_STATE.
Valeur retournée
Si le pilote appelant n’est actuellement pas paginable, la méthode WdfDevStateIsNP retourne TRUE. Sinon, la méthode retourne FALSE.
Remarques
Pour obtenir l’état actuel de la machine d’état d’alimentation de l’infrastructure, un pilote peut appeler WdfDeviceGetDevicePowerState à partir d’une fonction PnP ou de rappel d’alimentation. Pour obtenir l’état actuel de la machine d’état de la stratégie d’alimentation de l’infrastructure, un pilote peut appeler WdfDeviceGetDevicePowerPolicyState à partir d’une fonction de rappel de stratégie d’alimentation. Une fois que le pilote a appelé WdfDeviceGetDevicePowerState ou WdfDeviceGetDevicePowerPolicyState, il peut appeler WdfDevStateIsNP pour déterminer si l’état retourné représente un état paginable ou non paginable. Si l’ordinateur d’état de l’infrastructure est dans un état non paginable, le pilote n’est pas paginable et ne doit pas effectuer d’opérations susceptibles d’amener le système d’exploitation à accéder au fichier de pagination. Ces opérations incluent l’accès aux fichiers, au Registre ou au pool paginé.
Exemples
L’exemple de code suivant définit la valeur non pagéable sur TRUE si l’ordinateur d’état d’alimentation de l’infrastructure est actuellement dans un état non pagéable.
BOOLEAN nonpageable;
nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfdevice.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | N’importe quel niveau |