278 lines
7.0 KiB
C
278 lines
7.0 KiB
C
|
/*
|
||
|
|
* ntpoapi.h
|
||
|
|
*
|
||
|
|
* APIs for power management.
|
||
|
|
*
|
||
|
|
* This file is part of the w32api package.
|
||
|
|
*
|
||
|
|
* Contributors:
|
||
|
|
* Created by Casper S. Hornstrup <chorns@users.sourceforge.net>
|
||
|
|
*
|
||
|
|
* THIS SOFTWARE IS NOT COPYRIGHTED
|
||
|
|
*
|
||
|
|
* This source code is offered for use in the public domain. You may
|
||
|
|
* use, modify or distribute it freely.
|
||
|
|
*
|
||
|
|
* This code is distributed in the hope that it will be useful but
|
||
|
|
* WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY
|
||
|
|
* DISCLAIMED. This includes but is not limited to warranties of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef __NTPOAPI_H
|
||
|
|
#define __NTPOAPI_H
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#define POWER_PERF_SCALE 100
|
||
|
|
#define PERF_LEVEL_TO_PERCENT(x) (((x) * 1000) / (POWER_PERF_SCALE * 10))
|
||
|
|
#define PERCENT_TO_PERF_LEVEL(x) (((x) * POWER_PERF_SCALE * 10) / 1000)
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
ULONG Granularity;
|
||
|
|
ULONG Capacity;
|
||
|
|
} BATTERY_REPORTING_SCALE, *PBATTERY_REPORTING_SCALE;
|
||
|
|
|
||
|
|
typedef struct _PROCESSOR_IDLE_TIMES {
|
||
|
|
ULONGLONG StartTime;
|
||
|
|
ULONGLONG EndTime;
|
||
|
|
ULONG IdleHandlerReserved[4];
|
||
|
|
} PROCESSOR_IDLE_TIMES, *PPROCESSOR_IDLE_TIMES;
|
||
|
|
|
||
|
|
typedef BOOLEAN
|
||
|
|
(FASTCALL*PPROCESSOR_IDLE_HANDLER)(
|
||
|
|
IN OUT PPROCESSOR_IDLE_TIMES IdleTimes);
|
||
|
|
|
||
|
|
typedef struct _PROCESSOR_IDLE_HANDLER_INFO {
|
||
|
|
ULONG HardwareLatency;
|
||
|
|
PPROCESSOR_IDLE_HANDLER Handler;
|
||
|
|
} PROCESSOR_IDLE_HANDLER_INFO, *PPROCESSOR_IDLE_HANDLER_INFO;
|
||
|
|
|
||
|
|
typedef VOID
|
||
|
|
(FASTCALL*PSET_PROCESSOR_THROTTLE)(
|
||
|
|
IN UCHAR Throttle);
|
||
|
|
|
||
|
|
typedef NTSTATUS
|
||
|
|
(FASTCALL*PSET_PROCESSOR_THROTTLE2)(
|
||
|
|
IN UCHAR Throttle);
|
||
|
|
|
||
|
|
#define MAX_IDLE_HANDLERS 3
|
||
|
|
|
||
|
|
typedef struct _PROCESSOR_STATE_HANDLER {
|
||
|
|
UCHAR ThrottleScale;
|
||
|
|
BOOLEAN ThrottleOnIdle;
|
||
|
|
PSET_PROCESSOR_THROTTLE SetThrottle;
|
||
|
|
ULONG NumIdleHandlers;
|
||
|
|
PROCESSOR_IDLE_HANDLER_INFO IdleHandler[MAX_IDLE_HANDLERS];
|
||
|
|
} PROCESSOR_STATE_HANDLER, *PPROCESSOR_STATE_HANDLER;
|
||
|
|
|
||
|
|
typedef enum _POWER_STATE_HANDLER_TYPE {
|
||
|
|
PowerStateSleeping1,
|
||
|
|
PowerStateSleeping2,
|
||
|
|
PowerStateSleeping3,
|
||
|
|
PowerStateSleeping4,
|
||
|
|
PowerStateSleeping4Firmware,
|
||
|
|
PowerStateShutdownReset,
|
||
|
|
PowerStateShutdownOff,
|
||
|
|
PowerStateMaximum
|
||
|
|
} POWER_STATE_HANDLER_TYPE, *PPOWER_STATE_HANDLER_TYPE;
|
||
|
|
|
||
|
|
typedef NTSTATUS
|
||
|
|
(NTAPI*PENTER_STATE_SYSTEM_HANDLER)(
|
||
|
|
IN PVOID SystemContext);
|
||
|
|
|
||
|
|
typedef NTSTATUS
|
||
|
|
(NTAPI*PENTER_STATE_HANDLER)(
|
||
|
|
IN PVOID Context,
|
||
|
|
IN PENTER_STATE_SYSTEM_HANDLER SystemHandler OPTIONAL,
|
||
|
|
IN PVOID SystemContext,
|
||
|
|
IN LONG NumberProcessors,
|
||
|
|
IN LONG volatile *Number);
|
||
|
|
|
||
|
|
typedef struct _POWER_STATE_HANDLER {
|
||
|
|
POWER_STATE_HANDLER_TYPE Type;
|
||
|
|
BOOLEAN RtcWake;
|
||
|
|
UCHAR Spare[3];
|
||
|
|
PENTER_STATE_HANDLER Handler;
|
||
|
|
PVOID Context;
|
||
|
|
} POWER_STATE_HANDLER, *PPOWER_STATE_HANDLER;
|
||
|
|
|
||
|
|
typedef NTSTATUS
|
||
|
|
(NTAPI*PENTER_STATE_NOTIFY_HANDLER)(
|
||
|
|
IN POWER_STATE_HANDLER_TYPE State,
|
||
|
|
IN PVOID Context,
|
||
|
|
IN BOOLEAN Entering);
|
||
|
|
|
||
|
|
typedef struct _POWER_STATE_NOTIFY_HANDLER {
|
||
|
|
PENTER_STATE_NOTIFY_HANDLER Handler;
|
||
|
|
PVOID Context;
|
||
|
|
} POWER_STATE_NOTIFY_HANDLER, *PPOWER_STATE_NOTIFY_HANDLER;
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
DDKAPI
|
||
|
|
NtPowerInformation(
|
||
|
|
IN POWER_INFORMATION_LEVEL InformationLevel,
|
||
|
|
IN PVOID InputBuffer OPTIONAL,
|
||
|
|
IN ULONG InputBufferLength,
|
||
|
|
OUT PVOID OutputBuffer OPTIONAL,
|
||
|
|
IN ULONG OutputBufferLength);
|
||
|
|
|
||
|
|
#define PROCESSOR_STATE_TYPE_PERFORMANCE 1
|
||
|
|
#define PROCESSOR_STATE_TYPE_THROTTLE 2
|
||
|
|
|
||
|
|
typedef struct _PROCESSOR_PERF_LEVEL {
|
||
|
|
UCHAR PercentFrequency;
|
||
|
|
UCHAR Reserved;
|
||
|
|
USHORT Flags;
|
||
|
|
} PROCESSOR_PERF_LEVEL, *PPROCESSOR_PERF_LEVEL;
|
||
|
|
|
||
|
|
typedef struct _PROCESSOR_PERF_STATE {
|
||
|
|
UCHAR PercentFrequency;
|
||
|
|
UCHAR MinCapacity;
|
||
|
|
USHORT Power;
|
||
|
|
UCHAR IncreaseLevel;
|
||
|
|
UCHAR DecreaseLevel;
|
||
|
|
USHORT Flags;
|
||
|
|
ULONG IncreaseTime;
|
||
|
|
ULONG DecreaseTime;
|
||
|
|
ULONG IncreaseCount;
|
||
|
|
ULONG DecreaseCount;
|
||
|
|
ULONGLONG PerformanceTime;
|
||
|
|
} PROCESSOR_PERF_STATE, *PPROCESSOR_PERF_STATE;
|
||
|
|
|
||
|
|
typedef struct _PROCESSOR_STATE_HANDLER2 {
|
||
|
|
ULONG NumIdleHandlers;
|
||
|
|
PROCESSOR_IDLE_HANDLER_INFO IdleHandler[MAX_IDLE_HANDLERS];
|
||
|
|
PSET_PROCESSOR_THROTTLE2 SetPerfLevel;
|
||
|
|
ULONG HardwareLatency;
|
||
|
|
UCHAR NumPerfStates;
|
||
|
|
PROCESSOR_PERF_LEVEL PerfLevel[1];
|
||
|
|
} PROCESSOR_STATE_HANDLER2, *PPROCESSOR_STATE_HANDLER2;
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
NTAPI
|
||
|
|
NtSetThreadExecutionState(
|
||
|
|
IN EXECUTION_STATE esFlags,
|
||
|
|
OUT EXECUTION_STATE *PreviousFlags);
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
NTAPI
|
||
|
|
NtRequestWakeupLatency(
|
||
|
|
IN LATENCY_TIME latency);
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
NTAPI
|
||
|
|
NtInitiatePowerAction(
|
||
|
|
IN POWER_ACTION SystemAction,
|
||
|
|
IN SYSTEM_POWER_STATE MinSystemState,
|
||
|
|
IN ULONG Flags,
|
||
|
|
IN BOOLEAN Asynchronous);
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
NTAPI
|
||
|
|
NtSetSystemPowerState(
|
||
|
|
IN POWER_ACTION SystemAction,
|
||
|
|
IN SYSTEM_POWER_STATE MinSystemState,
|
||
|
|
IN ULONG Flags);
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
NTAPI
|
||
|
|
NtGetDevicePowerState(
|
||
|
|
IN HANDLE Device,
|
||
|
|
OUT DEVICE_POWER_STATE *State);
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
NTAPI
|
||
|
|
NtCancelDeviceWakeupRequest(
|
||
|
|
IN HANDLE Device);
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
BOOLEAN
|
||
|
|
NTAPI
|
||
|
|
NtIsSystemResumeAutomatic(
|
||
|
|
VOID);
|
||
|
|
|
||
|
|
NTSYSCALLAPI
|
||
|
|
NTSTATUS
|
||
|
|
NTAPI
|
||
|
|
NtRequestDeviceWakeup(
|
||
|
|
IN HANDLE Device);
|
||
|
|
|
||
|
|
#define WINLOGON_LOCK_ON_SLEEP 0x00000001
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
BOOLEAN PowerButtonPresent;
|
||
|
|
BOOLEAN SleepButtonPresent;
|
||
|
|
BOOLEAN LidPresent;
|
||
|
|
BOOLEAN SystemS1;
|
||
|
|
BOOLEAN SystemS2;
|
||
|
|
BOOLEAN SystemS3;
|
||
|
|
BOOLEAN SystemS4;
|
||
|
|
BOOLEAN SystemS5;
|
||
|
|
BOOLEAN HiberFilePresent;
|
||
|
|
BOOLEAN FullWake;
|
||
|
|
BOOLEAN VideoDimPresent;
|
||
|
|
BOOLEAN ApmPresent;
|
||
|
|
BOOLEAN UpsPresent;
|
||
|
|
BOOLEAN ThermalControl;
|
||
|
|
BOOLEAN ProcessorThrottle;
|
||
|
|
UCHAR ProcessorMinThrottle;
|
||
|
|
#if (NTDDI_VERSION < NTDDI_WINXP)
|
||
|
|
UCHAR ProcessorThrottleScale;
|
||
|
|
UCHAR spare2[4];
|
||
|
|
#else
|
||
|
|
UCHAR ProcessorMaxThrottle;
|
||
|
|
BOOLEAN FastSystemS4;
|
||
|
|
UCHAR spare2[3];
|
||
|
|
#endif // (NTDDI_VERSION < NTDDI_WINXP)
|
||
|
|
BOOLEAN DiskSpinDown;
|
||
|
|
UCHAR spare3[8];
|
||
|
|
BOOLEAN SystemBatteriesPresent;
|
||
|
|
BOOLEAN BatteriesAreShortTerm;
|
||
|
|
BATTERY_REPORTING_SCALE BatteryScale[3];
|
||
|
|
SYSTEM_POWER_STATE AcOnLineWake;
|
||
|
|
SYSTEM_POWER_STATE SoftLidWake;
|
||
|
|
SYSTEM_POWER_STATE RtcWake;
|
||
|
|
SYSTEM_POWER_STATE MinDeviceWakeState;
|
||
|
|
SYSTEM_POWER_STATE DefaultLowLatencyWake;
|
||
|
|
} SYSTEM_POWER_CAPABILITIES, *PSYSTEM_POWER_CAPABILITIES;
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
BOOLEAN AcOnLine;
|
||
|
|
BOOLEAN BatteryPresent;
|
||
|
|
BOOLEAN Charging;
|
||
|
|
BOOLEAN Discharging;
|
||
|
|
BOOLEAN Spare1[4];
|
||
|
|
ULONG MaxCapacity;
|
||
|
|
ULONG RemainingCapacity;
|
||
|
|
ULONG Rate;
|
||
|
|
ULONG EstimatedTime;
|
||
|
|
ULONG DefaultAlert1;
|
||
|
|
ULONG DefaultAlert2;
|
||
|
|
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;
|
||
|
|
|
||
|
|
typedef struct _PROCESSOR_POWER_INFORMATION {
|
||
|
|
ULONG Number;
|
||
|
|
ULONG MaxMhz;
|
||
|
|
ULONG CurrentMhz;
|
||
|
|
ULONG MhzLimit;
|
||
|
|
ULONG MaxIdleState;
|
||
|
|
ULONG CurrentIdleState;
|
||
|
|
} PROCESSOR_POWER_INFORMATION, *PPROCESSOR_POWER_INFORMATION;
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* __NTPOAPI_H */
|