_VPOWERD_Get_Power_State

POWERRET _VPOWERD_Get_Power_State(POWER_DEVICE_ID Power_Device_ID, 
    LPPOWER_STATE lpPower_State);
 

Retrieves the power state of a device or class of devices by passing the request directly to the APM BIOS. This function is available only for APM 1.1 connections.

Power_Device_ID
APM 1.1 identifier of the device. Use the Plug and Play BIOS function Get APM 1.1 ID Table (Function 0Bh) to retrieve an identifier.
lpPower_State
Address of a variable that receives the power state for a device. Can receive one of these values:
PSTATE_APM_ENABLED (0x0000) On
PSTATE_STANDBY (0x0001) Standby
PSTATE_SUSPEND (0x0002) Suspended
PSTATE_OFF (0x0003) Off
0x0030 thru 0x007F OEM-defined device states

All other values are reserved.

If Power_Device_ID specifies a class of devices (that is, the identifier has the form 0xxxFF), the function returns successfully only if the service _VPOWERD_Set_Device_Power_State has been previously used to set the state for that identifier.

This function does not supported the global system identifier 0x0001.