Функция WdfDevStateIsNP (wdfdevice.h)
[Относится к KMDF и UMDF]
Метод WdfDevStateIsNP возвращает логическое значение, указывающее, является ли указанное состояние питания или состояние политики управления питанием непередаваемым состоянием .
Синтаксис
BOOLEAN WdfDevStateIsNP(
[in] ULONG State
);
Параметры
[in] State
WDF_DEVICE_POWER_STATE типизированный перечислитель или перечислитель с WDF_DEVICE_POWER_POLICY_STATE типом.
Возвращаемое значение
Если вызывающий драйвер в настоящее время недоступен для страницы, метод WdfDevStateIsNP возвращает значение TRUE. В противном случае метод возвращает значение FALSE.
Комментарии
Чтобы получить текущее состояние конечного автомата управления питанием платформы, драйвер может вызвать WdfDeviceGetDevicePowerState из функции обратного вызова PnP или power. Чтобы получить текущее состояние конечного автомата политики управления питанием платформы, драйвер может вызвать WdfDeviceGetDevicePowerPolicyState из функции обратного вызова политики питания. После вызова драйвером WdfDeviceGetDevicePowerState или WdfDeviceGetDevicePowerPolicyStateState, он может вызвать WdfDevStateIsNP , чтобы определить, представляет ли возвращаемое состояние состояние страничного или нестраничного. Если конечный автомат платформы находится в нестраничном состоянии, драйвер не может быть доступен для страниц и не должен выполнять никаких операций, которые могут привести к доступу операционной системы к файлу подкачки. К таким операциям относится доступ к файлам, реестру или выгружаемого пулу.
Примеры
В следующем примере кода задается значениеTRUE , если конечный автомат power платформы в настоящее время находится в непагебельном состоянии.
BOOLEAN nonpageable;
nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));
Требования
Требование | Значение |
---|---|
Целевая платформа | Универсальное |
Минимальная версия KMDF | 1,0 |
Минимальная версия UMDF | 2,0 |
Верхняя часть | wdfdevice.h (включая Wdf.h) |
Библиотека | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | Любой уровень |