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

要件

こちらもご覧ください

WdfDeviceInitSetPowerNotPageable

WdfDeviceInitSetPowerPageable