_VPOWERD_Get_Power

_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.

Returns PR_SUCCESS if successful, or one of the error values beginning with PR_ listed in VPOWERD.H.

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.