GetDevicePowerState

Declare Function Api_GetDevicePowerState& Lib "kernel32" Alias "GetDevicePowerState" (ByVal hDevice&, ByRef pfOn&)

Declare Function GetDevicePowerState Lib "kernel32" Alias "GetDevicePowerState" (ByVal hDevice As Long, ByRef pfOn As Long) As Long

指定したデバイスの現在の電源状態を取得する。

パラメータ
hDevice
    ファイルやソケットのような、デバイスにあるオブジェクトのハンドル、またはデバイス自体のハンドルを指定する。
pfOn
    電源状態を受け取る変数へのポインタを指定する。デバイスの電源が完全に ON になっていると、変数に TRUE が返る。デバイスの電源

    が完全に ON になっていないと、変数に FALSE が返る。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。

解説
    GetSystemPowerState 関数を使うと、ディスクやほかのデバイスがスピンアップしているかどうかを確認できる。デバイスがスピンアップしてい

    ない場合、このデバイスへのアクセスは遅延する。
    この関数は、IOCTL_GET_DEVICE_POWER_STATUS コマンドを使って電源状態を確認する。