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