共用方式為


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 。 在驅動程式呼叫 WdfDeviceGetDevicePowerStateWdfDeviceGetDevicePowerPolicyState 之後,它可以呼叫 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 任何層級

另請參閱

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable