IAdapterPowerManagement::QueryPowerChangeState メソッド (portcls.h)
QueryPowerChangeState メソッドは、IRP_MN_QUERY_POWER power IRP の受信に応答して PortCls によって呼び出されます。
構文
NTSTATUS QueryPowerChangeState(
[in] POWER_STATE NewStateQuery
);
パラメーター
[in] NewStateQuery
デバイスに対して要求される新しい電源状態を指定します。 このパラメーターは、POWER_STATE型の和集合です。 新しい電源状態 (NewStateQuery.DeviceState) には、IAdapterPowerManagement::P owerChangeState に記載されているDEVICE_POWER_STATE列挙値のいずれかを指定できます。
戻り値
QueryPowerChangeState は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。
備考
PortCls は、システムの代わりに QueryPowerChangeState メソッドを呼び出して、潜在的なデバイスの電源状態の変更を受け入れるためにアダプター ドライバーにクエリを実行します。 ドライバーは、STATUS_SUCCESS以外の値を返すことによって電源状態の変更を拒否できます。
QueryPowerStateChange の呼び出しは、すべての powerChangeState 呼び出し 前に行われるとは限りません。
このメソッドのコードは、ページング されたメモリ内に存在する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | portcls.h (Portcls.h を含む) |