GetDevicePowerState 関数 (winbase.h)

指定したデバイスの現在の電源状態を取得します。 この関数を使用して、ディスプレイ デバイスの電源状態を照会することはできません。

構文

BOOL GetDevicePowerState(
  [in]  HANDLE hDevice,
  [out] BOOL   *pfOn
);

パラメーター

[in] hDevice

ファイルやソケットなどのデバイス上のオブジェクトへのハンドル、またはデバイス自体のハンドル。

[out] pfOn

電源状態を受け取る変数へのポインター。 デバイスが動作状態の場合、この値は TRUE です。 それ以外の場合は FALSE です。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

解説

アプリケーションでは 、GetDevicePowerState を 使用して、デバイスが動作状態か低電力状態かを判断できます。 デバイスが低電力状態の場合、デバイスにアクセスすると、キューまたは I/O 要求が失敗するか、デバイスが動作状態に移行する可能性があります。 正確な動作は、デバイスの実装によって異なります。

ラップトップ コンピューターの最大バッテリ寿命を確保するには、 GetDevicePowerState を 使用して消費電力を削減します。 たとえば、ディスクの電源が現在停止している場合、ディスクにアクセスするとスピンアップし、消費電力が増加し、バッテリ寿命が短縮されます。

システムがバッテリ電源で動作している間は、可能な限り、アプリケーションはデバイスへのアクセスを延期または制限する必要があります。 システムがバッテリ電源で実行されているかどうか、およびバッテリー残量を確認するには、 GetSystemPowerStatus 関数を使用します。

要件

関連項目

GetSystemPowerStatus

Power Management Functions

システム電源の状態