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 | 「解説」を参照してください。 |