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。
備註
若要取得架構電源狀態計算機的目前狀態,驅動程式可以從 PnP 或電源回呼函式內呼叫 WdfDeviceGetDevicePowerState 。 若要取得架構電源原則狀態計算機的目前狀態,驅動程式可以從電源原則回呼函式內呼叫 WdfDeviceGetDevicePowerPolicyState 。 在驅動程式呼叫 WdfDeviceGetDevicePowerState 或 WdfDeviceGetDevicePowerPolicyState 之後,它可以呼叫 WdfDevStateIsNP 來判斷傳回的狀態是否代表可分頁或不可分頁的狀態。 如果架構的狀態機器處於不可分頁的狀態,則驅動程式無法分頁,而且不得執行任何可能導致操作系統存取分頁檔案的作業。 這類作業包括存取檔案、登錄或分頁集區。
範例
如果架構的電源狀態機器目前處於不可分頁狀態,下列程式代碼範例會將 不可分頁 的值設定為 TRUE 。
BOOLEAN nonpageable;
nonpageable = WdfDevStateIsNP(WdfDeviceGetDevicePowerState(device));
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最小 KMDF 版本 | 1.0 |
最低UMDF版本 | 2.0 |
標頭 | wdfdevice.h (包含 Wdf.h) |
程式庫 | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
IRQL | 任何層級 |