次の方法で共有


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));

必要条件

要件 価値
ターゲット プラットフォーム 普遍
最小 KMDF バージョン 1.0
UMDF の最小バージョン する 2.0
ヘッダー wdfdevice.h (Wdf.h を含む)
図書館 Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL 任意のレベル

こちらもご覧ください

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable