IAdapterPowerManagement::QueryPowerChangeState メソッド (portcls.h)

[アーティクル]
02/29/2024

メソッドは QueryPowerChangeState 、 IRP_MN_QUERY_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 呼び出しの前に行われる保証はありません。

このメソッドのコードは、ページメモリ内に存在する必要があります。