WdfDevStateIsNP 函式 （wdfdevice.h）
[適用於 KMDF 和 UMDF]
WdfDevStateIsNP 方法會傳回 Boolean 值，指出指定的電源狀態或電源原則狀態是否為 不可分頁 狀態。
語法
BOOLEAN WdfDevStateIsNP(
[in] ULONG State
);
參數
[in] State
WDF_DEVICE_POWER_STATE型別列舉值或 WDF_DEVICE_POWER_POLICY_STATE型別列舉值。
返回值
如果呼叫驅動程式目前不可分頁，WdfDevStateIsNP 方法會傳回 true 。 否則，方法會傳回 false 。
備註
若要取得架構電源狀態機器的目前狀態，驅動程式可以從 PnP 或電源回呼函式內呼叫 WdfDeviceGetDevicePowerState。 若要取得架構電源原則狀態機器的目前狀態，驅動程式可以從電源原則回呼函式內呼叫 WdfDeviceGetDevicePowerPolicyState。 在驅動程式呼叫 WdfDeviceGetDevicePowerState 或 WdfDeviceGetDevicePowerPolicyState之後，它可以呼叫 WdfDevStateIsNP，以判斷傳回的狀態是否代表可分頁或不可分頁的狀態。 如果架構的狀態機器處於無法分頁的狀態，驅動程式將無法分頁，而且不得執行任何可能導致作系統存取分頁檔案的作業。 這類作業包括存取檔案、登錄或分頁集區。
範例
下列程式代碼範例會將 不可分頁 值設定為 TRUE 如果架構的電源狀態計算機目前處於不可分頁狀態。
BOOLEAN nonpageable;
nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));
需求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 標題 | wdfdevice.h （包括 Wdf.h） |
| 程式庫 | Wdf01000.sys （KMDF）：WUDFx02000.dll （UMDF） |
| IRQL | 任何層級 |