Does anyone know the proper use of "PowrProf.lib"

[Shooter]

I'm using RadASM 3.x with MASM32 selected, but I haven't figured out what I'm doing wrong to use PowrProf.lib. I keep getting this error:

ReadRegKey.asm(48) : error A2008: syntax error : CurGlPowPol

I'm trying to use the structure like this:

Code Select Expand

CurGlPowPol GLOBAL_USER_POWER_POLICY <?>

The last 'include' in my .inc file is:

Code Select Expand

includelib PowrProf.lib

I've tried a varying structs, but always the same error. Also, RadASM doesn't 'highlight' my 'definition' like the rest of my structs.

Ultimately I'm trying to change how Windows XP reacts to the press of the power button, but I've got to get passed this point first.


What am I doing wrong?

-Shooter

[fearless]

I had a look to see if GLOBAL_USER_POWER_POLICY was defined in windows.inc, winextra.inc, or powrprof.inc in \masm32\include. Doesn't seem to be. You will probably have to covert the structure from the ones on MSDN:

GLOBAL_USER_POWER_POLICY Structure http://msdn.microsoft.com/en-us/library/aa372697%28v=vs.85%29.aspx
POWER_ACTION_POLICY Structure http://msdn.microsoft.com/en-us/library/aa373148%28v=vs.85%29.aspx
POWER_ACTION Enumeration http://msdn.microsoft.com/en-us/library/aa373145%28v=vs.85%29.aspx

[Shooter]

I had a look to see if GLOBAL_USER_POWER_POLICY was defined in windows.inc, winextra.inc, or powrprof.inc in \masm32\include. Doesn't seem to be. You will probably have to covert the structure from the ones on MSDN:

GLOBAL_USER_POWER_POLICY Structure http://msdn.microsoft.com/en-us/library/aa372697%28v=vs.85%29.aspx
POWER_ACTION_POLICY Structure http://msdn.microsoft.com/en-us/library/aa373148%28v=vs.85%29.aspx
POWER_ACTION Enumeration http://msdn.microsoft.com/en-us/library/aa373145%28v=vs.85%29.aspx

I'm not sure how to do that just yet... still learning.

[donkey]

Might be easier to convert them from my headers, the complete powrprof.h file is part of the goasm header package, the structures are already pretty close to MASM syntax.

Code Select Expand

/*****************************************************************************\
*                                                                             *
* powrprof.h - - Interface for powrprof.dll, the power policy applicator      *
*                                                                             *
* Version 1.0                                                                 *
*                                                                             *
* Copyright (c) Microsoft Corporation. All rights reserved.                   *
*                                                                             *
\*****************************************************************************/

// Registry storage structures for the GLOBAL_POWER_POLICY data. There are two
// structures, GLOBAL_MACHINE_POWER_POLICY and GLOBAL_USER_POWER_POLICY. the
// GLOBAL_MACHINE_POWER_POLICY stores per machine data for which there is no UI.
// GLOBAL_USER_POWER_POLICY stores the per user data.

#IFNDEF POWRPROF_H
#DEFINE POWRPROF_H

#IFDEF LINKFILES
#dynamiclinkfile PowrProf.dll
#ENDIF

// SYSTEM_POWER_STATE enum
PowerSystemUnspecified   = 0
PowerSystemWorking       = 1
PowerSystemSleeping1     = 2
PowerSystemSleeping2     = 3
PowerSystemSleeping3     = 4
PowerSystemHibernate     = 5
PowerSystemShutdown      = 6
PowerSystemMaximum       = 7

// POWER_ACTION enum
PowerActionNone          = 0
PowerActionReserved      = 1
PowerActionSleep         = 2
PowerActionHibernate     = 3
PowerActionShutdown      = 4
PowerActionShutdownReset = 5
PowerActionShutdownOff   = 6
PowerActionWarmEject     = 7


GLOBAL_MACHINE_POWER_POLICY STRUCT
Revision LONG
LidOpenWakeAc ENUM // SYSTEM_POWER_STATE
LidOpenWakeDc ENUM // SYSTEM_POWER_STATE
BroadcastCapacityResolution LONG
ENDS

POWER_ACTION_POLICY STRUCT
Action ENUM //POWER_ACTION
Flags LONG
EventCode LONG
ENDS

SYSTEM_POWER_LEVEL STRUCT
Enable BOOLEAN
Spare CHAR 3 DUP
BatteryLevel LONG
PowerPolicy POWER_ACTION_POLICY
MinSystemState ENUM // SYSTEM_POWER_STATE
ENDS

GLOBAL_USER_POWER_POLICY STRUCT
Revision LONG
PowerButtonAc POWER_ACTION_POLICY
PowerButtonDc POWER_ACTION_POLICY
SleepButtonAc POWER_ACTION_POLICY
SleepButtonDc POWER_ACTION_POLICY
LidCloseAc POWER_ACTION_POLICY
LidCloseDc POWER_ACTION_POLICY
DischargePolicy SYSTEM_POWER_LEVEL NUM_DISCHARGE_POLICIES DUP
GlobalFlags LONG
ENDS

// Structure to manage global power policies at the user level. This structure
// contains data which is common across all power policy profiles.

GLOBAL_POWER_POLICY STRUCT
user GLOBAL_USER_POWER_POLICY
mach GLOBAL_MACHINE_POWER_POLICY
ENDS

// Registry storage structures for the POWER_POLICY data. There are three
// structures, MACHINE_POWER_POLICY, MACHINE_PROCESSOR_POWER_POLICY and
// USER_POWER_POLICY. the MACHINE_POWER_POLICY stores per machine data for
// which there is no UI.  USER_POWER_POLICY stores the per user data.

MACHINE_POWER_POLICY STRUCT
Revision LONG // 1

    // meaning of power action "sleep"
MinSleepAc ENUM // SYSTEM_POWER_STATE
MinSleepDc ENUM // SYSTEM_POWER_STATE
ReducedLatencySleepAc ENUM // SYSTEM_POWER_STATE
ReducedLatencySleepDc ENUM // SYSTEM_POWER_STATE

    // parameters for dozing
DozeTimeoutAc LONG
DozeTimeoutDc LONG
DozeS4TimeoutAc LONG
DozeS4TimeoutDc LONG

    // processor policies
MinThrottleAc CHAR
MinThrottleDc CHAR
pad1 CHAR 2 DUP
OverThrottledAc POWER_ACTION_POLICY
OverThrottledDc POWER_ACTION_POLICY
ENDS

//
// deprecated
//

PROCESSOR_POWER_POLICY_INFO STRUCT
TimeCheck LONG
DemoteLimit LONG
PromoteLimit LONG
DemotePercent CHAR
PromotePercent CHAR
Spare CHAR 2 DUP
AllowDemotion LONG
AllowPromotion LONG
Reserved LONG
ENDS

PROCESSOR_POWER_POLICY STRUCT
Revision DD
DynamicThrottle DB
Spare DB 3 DUP
DisableCStates DD
Reserved DD
PolicyCount DD
Policy PROCESSOR_POWER_POLICY_INFO 3 DUP
ENDS

MACHINE_PROCESSOR_POWER_POLICY STRUCT
Revision LONG // 1
ProcessorPolicyAc PROCESSOR_POWER_POLICY
ProcessorPolicyDc PROCESSOR_POWER_POLICY
ENDS

USER_POWER_POLICY STRUCT
Revision LONG // 1

    // "system idle" detection
IdleAc POWER_ACTION_POLICY
IdleDc POWER_ACTION_POLICY
IdleTimeoutAc LONG
IdleTimeoutDc LONG
IdleSensitivityAc CHAR
IdleSensitivityDc CHAR
   
    // Throttling Policy
ThrottlePolicyAc CHAR
ThrottlePolicyDc CHAR

    // meaning of power action "sleep"
MaxSleepAc ENUM // SYSTEM_POWER_STATE
MaxSleepDc ENUM // SYSTEM_POWER_STATE

    // For future use
Reserved LONG 2 DUP

    // video policies
VideoTimeoutAc LONG
VideoTimeoutDc LONG

    // hard disk policies
SpindownTimeoutAc LONG
SpindownTimeoutDc LONG

    // processor policies
OptimizeForPowerAc BOOLEAN
OptimizeForPowerDc BOOLEAN
FanThrottleToleranceAc CHAR
FanThrottleToleranceDc CHAR
ForcedThrottleAc CHAR
ForcedThrottleDc CHAR
ENDS

// Structure to manage power policies at the user level. This structure
// contains data which is unique across power policy profiles.

POWER_POLICY STRUCT
user USER_POWER_POLICY
mach MACHINE_POWER_POLICY
ENDS

// Constants for GlobalFlags

#define EnableSysTrayBatteryMeter   0x01
#define EnableMultiBatteryDisplay   0x02
#define EnablePasswordLogon         0x04
#define EnableWakeOnRing            0x08
#define EnableVideoDimDisplay       0x10

//
// Power setting attribute flags
//

#define POWER_ATTRIBUTE_HIDE        0x00000001

// This constant is passed as a uiID to WritePwrScheme.
#define NEWSCHEME -1

// ENUM POWER_DATA_ACCESSOR

ACCESS_AC_POWER_SETTING_INDEX = 0
ACCESS_DC_POWER_SETTING_INDEX = 1
ACCESS_FRIENDLY_NAME = 2
ACCESS_DESCRIPTION = 3
ACCESS_POSSIBLE_POWER_SETTING = 4
ACCESS_POSSIBLE_POWER_SETTING_FRIENDLY_NAME = 5
ACCESS_POSSIBLE_POWER_SETTING_DESCRIPTION = 6
ACCESS_DEFAULT_AC_POWER_SETTING = 7
ACCESS_DEFAULT_DC_POWER_SETTING = 8
ACCESS_POSSIBLE_VALUE_MIN = 9
ACCESS_POSSIBLE_VALUE_MAX = 10
ACCESS_POSSIBLE_VALUE_INCREMENT = 11
ACCESS_POSSIBLE_VALUE_UNITS = 12
ACCESS_ICON_RESOURCE = 13
ACCESS_DEFAULT_SECURITY_DESCRIPTOR = 14
ACCESS_ATTRIBUTES = 15
ACCESS_SCHEME = 16
ACCESS_SUBGROUP = 17
ACCESS_INDIVIDUAL_SETTING = 18
ACCESS_ACTIVE_SCHEME = 19
ACCESS_CREATE_SCHEME = 20
ACCESS_AC_POWER_SETTING_MAX = 21
ACCESS_DC_POWER_SETTING_MAX = 22
ACCESS_AC_POWER_SETTING_MIN = 23
ACCESS_DC_POWER_SETTING_MIN = 24

#define DEVICEPOWER_HARDWAREID 0x80000000
#define DEVICEPOWER_AND_OPERATION 0x40000000
#define DEVICEPOWER_FILTER_DEVICES_PRESENT 0x20000000
#define DEVICEPOWER_FILTER_HARDWARE 0x10000000
#define DEVICEPOWER_FILTER_WAKEENABLED 0x08000000
#define DEVICEPOWER_FILTER_WAKEPROGRAMMABLE 0x04000000
#define DEVICEPOWER_FILTER_ON_NAME 0x02000000
#define DEVICEPOWER_SET_WAKEENABLED 0x00000001
#define DEVICEPOWER_CLEAR_WAKEENABLED 0x00000002

#define PDCAP_S0_SUPPORTED              0x00010000
#define PDCAP_S1_SUPPORTED              0x00020000
#define PDCAP_S2_SUPPORTED              0x00040000
#define PDCAP_S3_SUPPORTED              0x00080000
#define PDCAP_WAKE_FROM_S0_SUPPORTED    0x00100000
#define PDCAP_WAKE_FROM_S1_SUPPORTED    0x00200000
#define PDCAP_WAKE_FROM_S2_SUPPORTED    0x00400000
#define PDCAP_WAKE_FROM_S3_SUPPORTED    0x00800000
#define PDCAP_S4_SUPPORTED              0x01000000
#define PDCAP_S5_SUPPORTED              0x02000000

#endif

[Shooter]

Edgar,
This is what is in my header file, but I'm not really sure if it's right, or what to do with it. It's in the MASM32 folder :(

Code Select Expand


/*****************************************************************************\
*                                                                             *
* powrprof.h - - Interface for powrprof.dll, the power policy applicator      *
*                                                                             *
* Version 1.0                                                                 *
*                                                                             *
* Copyright (c) Microsoft Corporation. All rights reserved.                   *
*                                                                             *
\*****************************************************************************/


// Define the following to debug batmeter on machines with no battery support.
//#define SIM_BATTERY 1

#define CURRENT_REVISION 1

#define STRSIZE(psz) ((lstrlen(psz) + 1) * sizeof(TCHAR))

#define MAX_NAME_LEN  32    // Max length of name in characters.
#define MAX_NAME_SIZE (MAX_NAME_LEN +1) * sizeof(TCHAR)

#define MAX_DESC_LEN  512   // Max length of description in characters.
#define MAX_DESC_SIZE (MAX_DESC_LEN +1) * sizeof(TCHAR)

#define SEMAPHORE_TIMEOUT  10000

#define NUM_DEC_DIGITS 10+1+1       // 10 digits + NUll and sign.
#define SIZE_DEC_DIGITS (10+1+1) * sizeof(TCHAR)

// Registry storage structures for the GLOBAL_POWER_POLICY data. There are two
// structures, GLOBAL_MACHINE_POWER_POLICY and GLOBAL_USER_POWER_POLICY. the
// GLOBAL_MACHINE_POWER_POLICY stores per machine data for which there is no UI.
// GLOBAL_USER_POWER_POLICY stores the per user data.

typedef struct _GLOBAL_MACHINE_POWER_POLICY{
    ULONG                   Revision;
    SYSTEM_POWER_STATE      LidOpenWakeAc;
    SYSTEM_POWER_STATE      LidOpenWakeDc;
    ULONG                   BroadcastCapacityResolution;
} GLOBAL_MACHINE_POWER_POLICY, *PGLOBAL_MACHINE_POWER_POLICY;

typedef struct _GLOBAL_USER_POWER_POLICY{
    ULONG                   Revision;
    POWER_ACTION_POLICY     PowerButtonAc;
    POWER_ACTION_POLICY     PowerButtonDc;
    POWER_ACTION_POLICY     SleepButtonAc;
    POWER_ACTION_POLICY     SleepButtonDc;
    POWER_ACTION_POLICY     LidCloseAc;
    POWER_ACTION_POLICY     LidCloseDc;
    SYSTEM_POWER_LEVEL      DischargePolicy[NUM_DISCHARGE_POLICIES];
    ULONG                   GlobalFlags;
} GLOBAL_USER_POWER_POLICY, *PGLOBAL_USER_POWER_POLICY;

// Structure to manage global power policies at the user level. This structure
// contains data which is common across all power policy profiles.

typedef struct _GLOBAL_POWER_POLICY{
    GLOBAL_USER_POWER_POLICY    user;
    GLOBAL_MACHINE_POWER_POLICY mach;
} GLOBAL_POWER_POLICY, *PGLOBAL_POWER_POLICY;


// Registry storage structures for the POWER_POLICY data. There are three
// structures, MACHINE_POWER_POLICY, MACHINE_PROCESSOR_POWER_POLICY and USER_POWER_POLICY. the
// MACHINE_POWER_POLICY stores per machine data for which there is no UI.
// USER_POWER_POLICY stores the per user data.

typedef struct _MACHINE_POWER_POLICY{
    ULONG                   Revision;       // 1

    // meaning of power action "sleep"
    SYSTEM_POWER_STATE      MinSleepAc;
    SYSTEM_POWER_STATE      MinSleepDc;
    SYSTEM_POWER_STATE      ReducedLatencySleepAc;
    SYSTEM_POWER_STATE      ReducedLatencySleepDc;

    // parameters for dozing
    ULONG                   DozeTimeoutAc;
    ULONG                   DozeTimeoutDc;
    ULONG                   DozeS4TimeoutAc;
    ULONG                   DozeS4TimeoutDc;

    // processor policies
    UCHAR                   MinThrottleAc;
    UCHAR                   MinThrottleDc;
    UCHAR                   pad1[2];
    POWER_ACTION_POLICY     OverThrottledAc;
    POWER_ACTION_POLICY     OverThrottledDc;

} MACHINE_POWER_POLICY, *PMACHINE_POWER_POLICY;

typedef struct _MACHINE_PROCESSOR_POWER_POLICY {
    ULONG                   Revision;       // 1
   
    PROCESSOR_POWER_POLICY  ProcessorPolicyAc;   
    PROCESSOR_POWER_POLICY  ProcessorPolicyDc;   

} MACHINE_PROCESSOR_POWER_POLICY, *PMACHINE_PROCESSOR_POWER_POLICY;

typedef struct _USER_POWER_POLICY{
    ULONG                   Revision;       // 1


    // "system idle" detection
    POWER_ACTION_POLICY     IdleAc;
    POWER_ACTION_POLICY     IdleDc;
    ULONG                   IdleTimeoutAc;
    ULONG                   IdleTimeoutDc;
    UCHAR                   IdleSensitivityAc;
    UCHAR                   IdleSensitivityDc;
   
    // Throttling Policy
    UCHAR                   ThrottlePolicyAc;
    UCHAR                   ThrottlePolicyDc;

    // meaning of power action "sleep"
    SYSTEM_POWER_STATE      MaxSleepAc;
    SYSTEM_POWER_STATE      MaxSleepDc;

    // For future use
    ULONG                   Reserved[2];

    // video policies
    ULONG                   VideoTimeoutAc;
    ULONG                   VideoTimeoutDc;

    // hard disk policies
    ULONG                   SpindownTimeoutAc;
    ULONG                   SpindownTimeoutDc;

    // processor policies
    BOOLEAN                 OptimizeForPowerAc;
    BOOLEAN                 OptimizeForPowerDc;
    UCHAR                   FanThrottleToleranceAc;
    UCHAR                   FanThrottleToleranceDc;
    UCHAR                   ForcedThrottleAc;
    UCHAR                   ForcedThrottleDc;
   
} USER_POWER_POLICY, *PUSER_POWER_POLICY;

// Structure to manage power policies at the user level. This structure
// contains data which is unique across power policy profiles.

typedef struct _POWER_POLICY{
    USER_POWER_POLICY       user;
    MACHINE_POWER_POLICY    mach;
} POWER_POLICY, *PPOWER_POLICY;


// Constants for GlobalFlags

#define EnableSysTrayBatteryMeter   0x01
#define EnableMultiBatteryDisplay   0x02
#define EnablePasswordLogon         0x04
#define EnableWakeOnRing            0x08
#define EnableVideoDimDisplay       0x10

// This constant is passed as a uiID to WritePwrScheme.
#define NEWSCHEME (UINT)-1

// Prototype for EnumPwrSchemes callback proceedures.

typedef BOOLEAN (CALLBACK* PWRSCHEMESENUMPROC)(UINT, DWORD, LPTSTR, DWORD, LPTSTR, PPOWER_POLICY, LPARAM);
typedef BOOLEAN (CALLBACK* PFNNTINITIATEPWRACTION)(POWER_ACTION, SYSTEM_POWER_STATE, ULONG, BOOLEAN);

// Public function prototypes

BOOLEAN WINAPI GetPwrDiskSpindownRange(PUINT, PUINT);
BOOLEAN WINAPI EnumPwrSchemes(PWRSCHEMESENUMPROC, LPARAM);
BOOLEAN WINAPI ReadGlobalPwrPolicy(PGLOBAL_POWER_POLICY);
BOOLEAN WINAPI ReadPwrScheme(UINT, PPOWER_POLICY);
BOOLEAN WINAPI WritePwrScheme(PUINT, LPTSTR, LPTSTR, PPOWER_POLICY);
BOOLEAN WINAPI WriteGlobalPwrPolicy(PGLOBAL_POWER_POLICY);
BOOLEAN WINAPI DeletePwrScheme(UINT);
BOOLEAN WINAPI GetActivePwrScheme(PUINT);
BOOLEAN WINAPI SetActivePwrScheme(UINT, PGLOBAL_POWER_POLICY, PPOWER_POLICY);
BOOLEAN WINAPI GetPwrCapabilities(PSYSTEM_POWER_CAPABILITIES);
BOOLEAN WINAPI IsPwrSuspendAllowed(VOID);
BOOLEAN WINAPI IsPwrHibernateAllowed(VOID);
BOOLEAN WINAPI IsPwrShutdownAllowed(VOID);
BOOLEAN WINAPI IsAdminOverrideActive(PADMINISTRATOR_POWER_POLICY);
BOOLEAN WINAPI SetSuspendState(BOOLEAN, BOOLEAN, BOOLEAN);
BOOLEAN WINAPI GetCurrentPowerPolicies(PGLOBAL_POWER_POLICY, PPOWER_POLICY);
BOOLEAN WINAPI CanUserWritePwrScheme(VOID);
BOOLEAN WINAPI ReadProcessorPwrScheme(UINT, PMACHINE_PROCESSOR_POWER_POLICY);
BOOLEAN WINAPI WriteProcessorPwrScheme(UINT, PMACHINE_PROCESSOR_POWER_POLICY);

#ifndef NT_SUCCESS
#define NTSTATUS LONG
#define _OVERRIDE_NTSTATUS_
#endif

NTSTATUS WINAPI CallNtPowerInformation(POWER_INFORMATION_LEVEL, PVOID, ULONG, PVOID, ULONG);

#ifdef _OVERRIDE_NTSTATUS_
#undef NTSTATUS
#endif

void WINAPI LoadCurrentPwrScheme(HWND hwnd, HINSTANCE hAppInstance, LPSTR lpszCmdLine, int nCmdShow);
void WINAPI MergeLegacyPwrScheme(HWND hwnd, HINSTANCE hAppInstance, LPSTR lpszCmdLine, int nCmdShow);