/* * batclass.h * * Battery class driver interface * * This file is part of the w32api package. * * Contributors: * Created by Casper S. Hornstrup * * 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 #if __GNUC__ >=3 #pragma GCC system_header #endif #ifdef __cplusplus extern "C" { #endif #pragma pack(push,4) #include "ntddk.h" #if defined(_BATTERYCLASS_) #define BCLASSAPI DECLSPEC_EXPORT #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; typedef struct _BATTERY_REPORTING_SCALE { ULONG Granularity; ULONG Capacity; } BATTERY_REPORTING_SCALE, *PBATTERY_REPORTING_SCALE; /* 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 DDKAPI (*BCLASS_DISABLE_STATUS_NOTIFY)( IN PVOID Context); typedef NTSTATUS DDKAPI (*BCLASS_QUERY_INFORMATION)( 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 DDKAPI (*BCLASS_QUERY_STATUS)( IN PVOID Context, IN ULONG BatteryTag, OUT PBATTERY_STATUS BatteryStatus); typedef NTSTATUS DDKAPI (*BCLASS_QUERY_TAG)( IN PVOID Context, OUT PULONG BatteryTag); typedef NTSTATUS DDKAPI (*BCLASS_SET_INFORMATION)( IN PVOID Context, IN ULONG BatteryTag, IN BATTERY_SET_INFORMATION_LEVEL Level, IN PVOID Buffer OPTIONAL); typedef NTSTATUS DDKAPI (*BCLASS_SET_STATUS_NOTIFY)( 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 DDKAPI BatteryClassInitializeDevice( IN PBATTERY_MINIPORT_INFO MiniportInfo, IN PVOID *ClassData); BCLASSAPI NTSTATUS DDKAPI BatteryClassIoctl( IN PVOID ClassData, IN PIRP Irp); BCLASSAPI NTSTATUS DDKAPI 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 DDKAPI BatteryClassStatusNotify( IN PVOID ClassData); BCLASSAPI NTSTATUS DDKAPI BatteryClassSystemControl( IN PVOID ClassData, IN PWMILIB_CONTEXT WmiLibContext, IN PDEVICE_OBJECT DeviceObject, IN PIRP Irp, OUT PSYSCTL_IRP_DISPOSITION Disposition); BCLASSAPI NTSTATUS DDKAPI BatteryClassUnload( IN PVOID ClassData); #pragma pack(pop) #ifdef __cplusplus } #endif #endif /* __BATCLASS_H */