Función WdfDevStateIsNP (wdfdevice.h)

[Se aplica a KMDF y UMDF]

El método WdfDevStateIsNP devuelve un valor booleano que indica si un estado de energía especificado o un estado de directiva de energía es un estado no paginable.

Sintaxis

BOOLEAN WdfDevStateIsNP(
  [in] ULONG State
);

Parámetros

[in] State

Enumerador con tipo WDF_DEVICE_POWER_STATEo un enumerador con tipo WDF_DEVICE_POWER_POLICY_STATE.

Valor devuelto

Si el controlador de llamada no se puede paginar actualmente, el método WdfDevStateIsNP devuelve TRUE. De lo contrario, el método devuelve FALSE.

Observaciones

Para obtener el estado actual de la máquina de estado de energía del marco, un controlador puede llamar a WdfDeviceGetDevicePowerState desde dentro de una función PnP o de devolución de llamada de energía. Para obtener el estado actual de la máquina de estado de la directiva de energía del marco, un controlador puede llamar a WdfDeviceGetDevicePowerPolicyState desde una función de devolución de llamada de directiva de energía. Después de llamar al controlador WdfDeviceGetDevicePowerState o WdfDeviceGetDevicePowerPolicyState, puede llamar a WdfDevStateIsNP para determinar si el estado devuelto representa un estado paginable o no paginable. Si la máquina de estado del marco está en un estado no paginable, el controlador no se puede paginar y no debe realizar ninguna operación que pueda hacer que el sistema operativo acceda al archivo de paginación. Estas operaciones incluyen el acceso a archivos, el registro o el grupo paginado.

Ejemplos

En el ejemplo de código siguiente se establece el valor no paginable en TRUE si la máquina de estado de energía del marco está actualmente en un estado no paginable.

BOOLEAN nonpageable;

nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));

Requisitos

Consulte también

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable