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

[アーティクル]
08/07/2023

メソッドはQueryDeviceCapabilities、プラグアンドプレイ IRP_MN_QUERY_CAPABILITIES IRP に応答して PortCls によって呼び出されます。

構文

NTSTATUS QueryDeviceCapabilities(
  [in] PDEVICE_CAPABILITIES PowerDeviceCaps
);

パラメーター

[in] PowerDeviceCaps

デバイスの機能を指定する DEVICE_CAPABILITIES 構造体へのポインター

戻り値

QueryDeviceCapabilities は、呼び出しが成功した場合STATUS_SUCCESSを返します。それ以外の場合、メソッドは適切なエラーコードを返します。

注釈

このメソッドは、デバイスの機能を取得するためにドライバーの起動時に呼び出されます。メソッドは、システム電源状態とデバイスの電源状態の間のマッピングを定義する機能構造をアダプタードライバーに渡します。 PortCls は、メソッドを呼び出す前に、これらのマッピングの既定値を構造体に書き込みます。呼び出し中に、アダプタードライバーは、必要に応じて、マッピングを編集する機会を持っています。

通常、アダプタードライバーはこれらの設定を変更しないでください。アダプタードライバーが既定値をオーバーライドする必要がある場合は、マッピングをより深い (電力の少ない) デバイスの電源状態に変更できますが、弱い (より強力な) デバイスの電源状態には変更できません。たとえば、S1 (PowerSystemSleeping1) のマッピングは D1 から D3 に変更できますが、D0 には変更できません。

デバイスの PowerDeviceCaps 構造体を埋めるために、アダプタードライバーは PcRegisterAdapterPowerManagement を呼び出して、デバイスの起動時に IAdapterPowerManagement インターフェイスを 登録する必要があります。オペレーティングシステムは、アダプタードライバーのデバイススタートアップルーチンを呼び出す前に、デバイスに対してクエリを実行します。

システムの電源状態とデバイスの電源状態の間のマッピングを変更するために、アダプタードライバーは、PowerDeviceCaps 構造体の DeviceState 配列の値を変更します。これらのマッピングは、必要な場合にのみ変更する必要があります。次のコード例は、D1 マッピングを D3 にマップする方法を示しています。

  for (i=ULONG(PowerSystemWorking); i<=ULONG(PowerSystemShutdown); i++)
      {
          if (PowerDeviceCaps->DeviceState[i] == PowerDeviceD1)
          {
              PowerDeviceCaps->DeviceState[i] = PowerDeviceD3;
          }
      }

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