Partager via

WdfDevStateIsNP, fonction (wdfdevice.h)

  • Article

[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

Voir aussi

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable