_VPOWERD_Set_Device_Power_State

POWERRET _VPOWERD_Set_Device_Power_State(
    POWER_DEVICE_ID Power_Device_ID, POWER_STATE Power_State);
 

Sets the power management state for a given device by passing the request directly to the APM BIOS. This service 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.

Power_State

Power state for the device. Can be 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.

This service returns 0x0001 if the power management level is off and 0x000B if the power management level is standard.