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_STATE o 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.
Comentarios
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 de devolución de llamada de alimentación o PnP. 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. Una vez que el controlador haya llamado a 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 tenga acceso 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
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.h (incluya Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | Cualquier nivel |