次の方法で共有


PoSetPowerState 関数 (ntifs.h)

PoSetPowerState ルーチンは、デバイスのデバイス電源状態の変更をシステムに通知します。

構文

POWER_STATE PoSetPowerState(
  [in] PDEVICE_OBJECT   DeviceObject,
  [in] POWER_STATE_TYPE Type,
  [in] POWER_STATE      State
);

パラメーター

[in] DeviceObject

ターゲット DEVICE_OBJECTへのポインター。

[in] Type

POWER_STATE_TYPE値を示します。 ドライバーは DevicePowerState を指定する必要があります。

[in] State

設定する電源状態を指定します。 ドライバーでは 、DEVICE_POWER_STATE 値を指定する必要があります。

戻り値

PoSetPowerState は、以前の電源状態を返します。

注釈

PoSetPowerState は、デバイスの新しい電源状態を 電源マネージャー に通知します。 デバイス スタック内の各ドライバー (フィルター、関数、バス ドライバー) は PoSetPowerState を呼び出して、対応するデバイス オブジェクトの電源状態の変化を電源マネージャーに通知する必要があります。 例:

  • ドライバーは、デバイスの set-power 要求を受信した後、 PoStartNextPowerIrp を呼び出す前に、このルーチンを呼び出します。 PnP IRP_MN_START_DEVICE 要求を処理する場合、ドライバーは PoSetPowerState を呼び出して、デバイスが D0 状態であることを電源マネージャーに通知する必要があります。

  • デバイスの電源が切れている場合、ドライバーは D0 状態を終了する前に PoSetPowerState を呼び出す必要があります。 さらに、 ドライバーは、PoSetPowerState が返される前にクライアント要求を処理できる必要があります。

  • デバイスの電源が入っている場合、ドライバーは、デバイスが D0 状態に正常に配置された後に PoSetPowerState を呼び出す必要があります。

デバイスの電源を上下に切り替える方法の詳細については、「デバイスの 電源状態のIRP_MN_SET_POWERの処理」を参照してください。

PoSetPowerState の呼び出し元は、状態を D0 に設定する場合を除き、IRQL <= APC_LEVELで実行されている必要があります。 状態を D0 に設定すると、呼び出し元は IRQL <= DISPATCH_LEVELで実行できます。

要件

要件
サポートされている最小のクライアント Windows 2000
対象プラットフォーム ユニバーサル
Header ntifs.h (Wdm.h、Ntddk.h、Ntifs.h を含みます)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL 「解説」を参照してください。

こちらもご覧ください

IRP_MN_START_DEVICE

PoStartNextPowerIrp