2006-02-17 23:20:14 +00:00
|
|
|
/*
|
|
|
|
* batclass.h
|
|
|
|
*
|
|
|
|
* Battery class driver interface
|
|
|
|
*
|
|
|
|
* 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 __BATCLASS_H
|
|
|
|
#define __BATCLASS_H
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(_BATTERYCLASS_)
|
2009-08-20 13:45:01 +00:00
|
|
|
#define BCLASSAPI
|
2006-02-17 23:20:14 +00:00
|
|
|
#else
|
|
|
|
#define BCLASSAPI DECLSPEC_IMPORT
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
/* Battery device GUIDs */
|
|
|
|
|
|
|
|
DEFINE_GUID(GUID_DEVICE_BATTERY,
|
|
|
|
0x72631e54L, 0x78A4, 0x11d0, 0xbc, 0xf7, 0x00, 0xaa, 0x00, 0xb7, 0xb3, 0x2a);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_STATUS_WMI_GUID,
|
|
|
|
0xfc4670d1, 0xebbf, 0x416e, 0x87, 0xce, 0x37, 0x4a, 0x4e, 0xbc, 0x11, 0x1a);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_RUNTIME_WMI_GUID,
|
|
|
|
0x535a3767, 0x1ac2, 0x49bc, 0xa0, 0x77, 0x3f, 0x7a, 0x02, 0xe4, 0x0a, 0xec);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_TEMPERATURE_WMI_GUID,
|
|
|
|
0x1a52a14d, 0xadce, 0x4a44, 0x9a, 0x3e, 0xc8, 0xd8, 0xf1, 0x5f, 0xf2, 0xc2);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_FULL_CHARGED_CAPACITY_WMI_GUID,
|
|
|
|
0x40b40565, 0x96f7, 0x4435, 0x86, 0x94, 0x97, 0xe0, 0xe4, 0x39, 0x59, 0x05);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_CYCLE_COUNT_WMI_GUID,
|
|
|
|
0xef98db24, 0x0014, 0x4c25, 0xa5, 0x0b, 0xc7, 0x24, 0xae, 0x5c, 0xd3, 0x71);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_STATIC_DATA_WMI_GUID,
|
|
|
|
0x05e1e463, 0xe4e2, 0x4ea9, 0x80, 0xcb, 0x9b, 0xd4, 0xb3, 0xca, 0x06, 0x55);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_STATUS_CHANGE_WMI_GUID,
|
|
|
|
0xcddfa0c3, 0x7c5b, 0x4e43, 0xa0, 0x34, 0x05, 0x9f, 0xa5, 0xb8, 0x43, 0x64);
|
|
|
|
|
|
|
|
DEFINE_GUID(BATTERY_TAG_CHANGE_WMI_GUID,
|
|
|
|
0x5e1f6e19, 0x8786, 0x4d23, 0x94, 0xfc, 0x9e, 0x74, 0x6b, 0xd5, 0xd8, 0x88);
|
|
|
|
|
|
|
|
|
|
|
|
/* BATTERY_INFORMATION.Capabilities constants */
|
|
|
|
#define BATTERY_SET_CHARGE_SUPPORTED 0x00000001
|
|
|
|
#define BATTERY_SET_DISCHARGE_SUPPORTED 0x00000002
|
|
|
|
#define BATTERY_SET_RESUME_SUPPORTED 0x00000004
|
|
|
|
#define BATTERY_IS_SHORT_TERM 0x20000000
|
|
|
|
#define BATTERY_CAPACITY_RELATIVE 0x40000000
|
|
|
|
#define BATTERY_SYSTEM_BATTERY 0x80000000
|
|
|
|
|
|
|
|
typedef struct _BATTERY_INFORMATION {
|
|
|
|
ULONG Capabilities;
|
|
|
|
UCHAR Technology;
|
|
|
|
UCHAR Reserved[3];
|
|
|
|
UCHAR Chemistry[4];
|
|
|
|
ULONG DesignedCapacity;
|
|
|
|
ULONG FullChargedCapacity;
|
|
|
|
ULONG DefaultAlert1;
|
|
|
|
ULONG DefaultAlert2;
|
|
|
|
ULONG CriticalBias;
|
|
|
|
ULONG CycleCount;
|
|
|
|
} BATTERY_INFORMATION, *PBATTERY_INFORMATION;
|
|
|
|
|
|
|
|
typedef struct _BATTERY_MANUFACTURE_DATE {
|
|
|
|
UCHAR Day;
|
|
|
|
UCHAR Month;
|
|
|
|
USHORT Year;
|
|
|
|
} BATTERY_MANUFACTURE_DATE, *PBATTERY_MANUFACTURE_DATE;
|
|
|
|
|
|
|
|
typedef struct _BATTERY_NOTIFY {
|
|
|
|
ULONG PowerState;
|
|
|
|
ULONG LowCapacity;
|
|
|
|
ULONG HighCapacity;
|
|
|
|
} BATTERY_NOTIFY, *PBATTERY_NOTIFY;
|
|
|
|
|
|
|
|
/* BATTERY_STATUS.PowerState flags */
|
|
|
|
#define BATTERY_POWER_ON_LINE 0x00000001
|
|
|
|
#define BATTERY_DISCHARGING 0x00000002
|
|
|
|
#define BATTERY_CHARGING 0x00000004
|
|
|
|
#define BATTERY_CRITICAL 0x00000008
|
|
|
|
|
|
|
|
/* BATTERY_STATUS.Voltage constant */
|
|
|
|
#define BATTERY_UNKNOWN_VOLTAGE 0xFFFFFFFF
|
|
|
|
|
|
|
|
/* BATTERY_STATUS.Rate constant */
|
|
|
|
#define BATTERY_UNKNOWN_RATE 0x80000000
|
|
|
|
|
|
|
|
typedef struct _BATTERY_STATUS {
|
|
|
|
ULONG PowerState;
|
|
|
|
ULONG Capacity;
|
|
|
|
ULONG Voltage;
|
|
|
|
LONG Rate;
|
|
|
|
} BATTERY_STATUS, *PBATTERY_STATUS;
|
|
|
|
|
|
|
|
/* BATTERY_INFORMATION.Capacity constants */
|
|
|
|
#define BATTERY_UNKNOWN_CAPACITY 0xFFFFFFFF
|
|
|
|
|
|
|
|
typedef enum _BATTERY_QUERY_INFORMATION_LEVEL {
|
|
|
|
BatteryInformation = 0,
|
|
|
|
BatteryGranularityInformation,
|
|
|
|
BatteryTemperature,
|
|
|
|
BatteryEstimatedTime,
|
|
|
|
BatteryDeviceName,
|
|
|
|
BatteryManufactureDate,
|
|
|
|
BatteryManufactureName,
|
|
|
|
BatteryUniqueID,
|
|
|
|
BatterySerialNumber
|
|
|
|
} BATTERY_QUERY_INFORMATION_LEVEL;
|
|
|
|
|
|
|
|
/* BatteryEstimatedTime constant */
|
|
|
|
#define BATTERY_UNKNOWN_TIME 0x80000000
|
|
|
|
|
|
|
|
/* NTSTATUS possibly returned by BCLASS_QUERY_STATUS */
|
|
|
|
#define BATTERY_TAG_INVALID 0
|
|
|
|
|
|
|
|
typedef struct _BATTERY_QUERY_INFORMATION {
|
|
|
|
ULONG BatteryTag;
|
|
|
|
BATTERY_QUERY_INFORMATION_LEVEL InformationLevel;
|
|
|
|
LONG AtRate;
|
|
|
|
} BATTERY_QUERY_INFORMATION, *PBATTERY_QUERY_INFORMATION;
|
|
|
|
|
|
|
|
typedef enum _BATTERY_SET_INFORMATION_LEVEL {
|
|
|
|
BatteryCriticalBias = 0,
|
|
|
|
BatteryCharge,
|
|
|
|
BatteryDischarge
|
|
|
|
} BATTERY_SET_INFORMATION_LEVEL;
|
|
|
|
|
|
|
|
#define MAX_BATTERY_STRING_SIZE 128
|
|
|
|
|
|
|
|
typedef struct _BATTERY_SET_INFORMATION {
|
|
|
|
ULONG BatteryTag;
|
|
|
|
BATTERY_SET_INFORMATION_LEVEL InformationLevel;
|
|
|
|
UCHAR Buffer[1];
|
|
|
|
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;
|
|
|
|
|
|
|
|
typedef struct _BATTERY_WAIT_STATUS {
|
|
|
|
ULONG BatteryTag;
|
|
|
|
ULONG Timeout;
|
|
|
|
ULONG PowerState;
|
|
|
|
ULONG LowCapacity;
|
|
|
|
ULONG HighCapacity;
|
|
|
|
} BATTERY_WAIT_STATUS, *PBATTERY_WAIT_STATUS;
|
|
|
|
|
|
|
|
|
|
|
|
#define IOCTL_BATTERY_QUERY_TAG \
|
|
|
|
CTL_CODE(FILE_DEVICE_BATTERY, 0x10, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
|
|
|
|
#define IOCTL_BATTERY_QUERY_INFORMATION \
|
|
|
|
CTL_CODE(FILE_DEVICE_BATTERY, 0x11, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
|
|
|
|
#define IOCTL_BATTERY_SET_INFORMATION \
|
|
|
|
CTL_CODE(FILE_DEVICE_BATTERY, 0x12, METHOD_BUFFERED, FILE_WRITE_ACCESS)
|
|
|
|
|
|
|
|
#define IOCTL_BATTERY_QUERY_STATUS \
|
|
|
|
CTL_CODE(FILE_DEVICE_BATTERY, 0x13, METHOD_BUFFERED, FILE_READ_ACCESS)
|
|
|
|
|
|
|
|
|
|
|
|
typedef NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
(NTAPI *BCLASS_DISABLE_STATUS_NOTIFY)(
|
2006-02-17 23:20:14 +00:00
|
|
|
IN PVOID Context);
|
|
|
|
|
|
|
|
typedef NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
(NTAPI *BCLASS_QUERY_INFORMATION)(
|
2006-02-17 23:20:14 +00:00
|
|
|
IN PVOID Context,
|
|
|
|
IN ULONG BatteryTag,
|
|
|
|
IN BATTERY_QUERY_INFORMATION_LEVEL Level,
|
|
|
|
IN LONG AtRate OPTIONAL,
|
|
|
|
OUT PVOID Buffer,
|
|
|
|
IN ULONG BufferLength,
|
|
|
|
OUT PULONG ReturnedLength);
|
|
|
|
|
|
|
|
typedef NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
(NTAPI *BCLASS_QUERY_STATUS)(
|
2006-02-17 23:20:14 +00:00
|
|
|
IN PVOID Context,
|
|
|
|
IN ULONG BatteryTag,
|
|
|
|
OUT PBATTERY_STATUS BatteryStatus);
|
|
|
|
|
|
|
|
typedef NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
(NTAPI *BCLASS_QUERY_TAG)(
|
2006-02-17 23:20:14 +00:00
|
|
|
IN PVOID Context,
|
|
|
|
OUT PULONG BatteryTag);
|
|
|
|
|
|
|
|
typedef NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
(NTAPI *BCLASS_SET_INFORMATION)(
|
2006-02-17 23:20:14 +00:00
|
|
|
IN PVOID Context,
|
|
|
|
IN ULONG BatteryTag,
|
|
|
|
IN BATTERY_SET_INFORMATION_LEVEL Level,
|
|
|
|
IN PVOID Buffer OPTIONAL);
|
|
|
|
|
|
|
|
typedef NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
(NTAPI *BCLASS_SET_STATUS_NOTIFY)(
|
2006-02-17 23:20:14 +00:00
|
|
|
IN PVOID Context,
|
|
|
|
IN ULONG BatteryTag,
|
|
|
|
IN PBATTERY_NOTIFY BatteryNotify);
|
|
|
|
|
|
|
|
|
|
|
|
typedef struct _BATTERY_MINIPORT_INFO {
|
|
|
|
USHORT MajorVersion;
|
|
|
|
USHORT MinorVersion;
|
|
|
|
PVOID Context;
|
|
|
|
BCLASS_QUERY_TAG QueryTag;
|
|
|
|
BCLASS_QUERY_INFORMATION QueryInformation;
|
|
|
|
BCLASS_SET_INFORMATION SetInformation;
|
|
|
|
BCLASS_QUERY_STATUS QueryStatus;
|
|
|
|
BCLASS_SET_STATUS_NOTIFY SetStatusNotify;
|
|
|
|
BCLASS_DISABLE_STATUS_NOTIFY DisableStatusNotify;
|
|
|
|
PDEVICE_OBJECT Pdo;
|
|
|
|
PUNICODE_STRING DeviceName;
|
|
|
|
} BATTERY_MINIPORT_INFO, *PBATTERY_MINIPORT_INFO;
|
|
|
|
|
|
|
|
/* BATTERY_MINIPORT_INFO.XxxVersion */
|
|
|
|
#define BATTERY_CLASS_MAJOR_VERSION 0x0001
|
|
|
|
#define BATTERY_CLASS_MINOR_VERSION 0x0000
|
|
|
|
|
|
|
|
|
|
|
|
BCLASSAPI
|
|
|
|
NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
NTAPI
|
2006-02-17 23:20:14 +00:00
|
|
|
BatteryClassInitializeDevice(
|
|
|
|
IN PBATTERY_MINIPORT_INFO MiniportInfo,
|
|
|
|
IN PVOID *ClassData);
|
|
|
|
|
|
|
|
BCLASSAPI
|
|
|
|
NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
NTAPI
|
2006-02-17 23:20:14 +00:00
|
|
|
BatteryClassIoctl(
|
|
|
|
IN PVOID ClassData,
|
|
|
|
IN PIRP Irp);
|
|
|
|
|
|
|
|
BCLASSAPI
|
|
|
|
NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
NTAPI
|
2006-02-17 23:20:14 +00:00
|
|
|
BatteryClassQueryWmiDataBlock(
|
|
|
|
IN PVOID ClassData,
|
|
|
|
IN PDEVICE_OBJECT DeviceObject,
|
|
|
|
IN PIRP Irp,
|
|
|
|
IN ULONG GuidIndex,
|
|
|
|
IN OUT PULONG InstanceLengthArray,
|
|
|
|
IN ULONG OutBufferSize,
|
|
|
|
OUT PUCHAR Buffer);
|
|
|
|
|
|
|
|
BCLASSAPI
|
|
|
|
NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
NTAPI
|
2006-02-17 23:20:14 +00:00
|
|
|
BatteryClassStatusNotify(
|
|
|
|
IN PVOID ClassData);
|
|
|
|
|
|
|
|
BCLASSAPI
|
|
|
|
NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
NTAPI
|
2006-02-17 23:20:14 +00:00
|
|
|
BatteryClassSystemControl(
|
|
|
|
IN PVOID ClassData,
|
2010-03-12 16:37:33 +00:00
|
|
|
IN PVOID WmiLibContext, /* PWMILIB_CONTEXT */
|
2006-02-17 23:20:14 +00:00
|
|
|
IN PDEVICE_OBJECT DeviceObject,
|
|
|
|
IN PIRP Irp,
|
2010-03-12 16:37:33 +00:00
|
|
|
OUT PVOID Disposition); /* PSYSCTL_IRP_DISPOSITION */
|
2006-02-17 23:20:14 +00:00
|
|
|
|
|
|
|
BCLASSAPI
|
|
|
|
NTSTATUS
|
2010-03-23 16:38:10 +00:00
|
|
|
NTAPI
|
2006-02-17 23:20:14 +00:00
|
|
|
BatteryClassUnload(
|
|
|
|
IN PVOID ClassData);
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif /* __BATCLASS_H */
|