#ifndef _NTPOAPI_H

// rev
/**
 * The POWER_INFORMATION_ENERGY_TRACKER_STATISTICS structure contains tracker diagnostic counters.
 *
 * StatisticsOffset and CumulativeStatisticsOffset in POWER_INFORMATION_ENERGY_TRACKER_QUERY_HEADER
 * and POWER_INFORMATION_ENERGY_TRACKER_QUERY_OUTPUT both locate this 0x10-byte structure.
 * StatisticsOffset reports counters accumulated since creation or the previous successful query.
 * CumulativeStatisticsOffset reports the previous cumulative totals plus the current-query counters.
 * A successful query clears the current counters and retains the updated cumulative totals.
 * These are event counts, not energy values or counts of distinct processes.
 *
 * AggregateFallbackCount includes failures to allocate or insert an aggregate and attempts blocked
 * by MaxTrackedProcesses. AggregateLimitHitCount counts the latter attempts as well, so these
 * counters overlap and must not be added together as independent failure totals.
 * ProcessSnapshotMissCount increments when no snapshot is found outside tracker initialization,
 * the snapshot reason is not 1 (initial enumeration), and the process energy-state sequence is greater than 1.
 * ProcessSnapshotFailureCount counts failures to allocate a process snapshot or its initial hash table.
 */
typedef struct _POWER_INFORMATION_ENERGY_TRACKER_STATISTICS
{
    ULONG AggregateFallbackCount;            // Updates directed to the built-in fallback aggregate.
    ULONG ProcessSnapshotMissCount;          // Missing snapshots satisfying the conditions above.
    ULONG ProcessSnapshotFailureCount;       // Process snapshot creation failures.
    ULONG AggregateLimitHitCount;            // Aggregate creation attempts blocked by MaxTrackedProcesses.
} POWER_INFORMATION_ENERGY_TRACKER_STATISTICS, *PPOWER_INFORMATION_ENERGY_TRACKER_STATISTICS;

#endif
View code on GitHub