структура PO_FX_COMPONENT_PERF_SET (wdm.h)
Структура PO_FX_COMPONENT_PERF_SET представляет набор состояний производительности для одного компонента на устройстве.
Синтаксис
typedef struct _PO_FX_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PO_FX_PERF_STATE_UNIT Unit;
PO_FX_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPO_FX_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PO_FX_COMPONENT_PERF_SET, *PPO_FX_COMPONENT_PERF_SET;
Члены
Name
Необязательная строка символов, используемая для описания свойства компонента, управляемого набором состояний производительности. Например, "Тактовая частота" или "Пропускная способность памяти".
Flags
Задайте значение 0. В настоящее время флаги для этого элемента не определены.
Unit
Значение PO_FX_PERF_STATE_UNIT , указывающее тип единицы измерения, которая управляется набором состояний производительности.
Type
Значение PO_FX_PERF_STATE_TYPE , указывающее тип состояний производительности в наборе (дискретное количество состояний или непрерывное распределение состояний между минимальным и максимальным значением).
Discrete
Для наборов, представляющих дискретное количество состояний производительности (то есть, где элементОм Type является PoFxPerfStateTypeDiscrete), эта вложенная структура описывает состояния.
Discrete.Count
Количество состояний производительности в наборе.
Discrete.States
Указатель на массив PO_FX_PERF_STATE . Длина этого массива определяется элементом Count . Каждый элемент массива описывает одно состояние питания в наборе.
Range
Для наборов, представляющих непрерывное распределение состояний производительности (то есть, где элементОм Type является PoFxPerfStateTypeRange), эта вложенная структура описывает минимальное и максимальное значение диапазона состояний производительности.
Range.Minimum
Минимальное значение состояния производительности.
Range.Maximum
Максимальное значение состояния производительности.
Комментарии
Когда драйвер устройства вызывает подпрограмму PoFxRegisterComponentPerfStates для регистрации компонента для поддержки состояния производительности с помощью платформы управления питанием (PoFx), драйвер может предоставить PO_FX_COMPONENT_PERF_INFO структуру, описывающую наборы состояний производительности, поддерживаемые компонентом. Элемент PerfStateSets структуры PO_FX_COMPONENT_PERF_INFO содержит массив PO_FX_COMPONENT_PERF_SET структур, представляющих поддерживаемые состояния производительности.
Ожидается, что большинство драйверов определяют единый набор состояний производительности для каждого компонента. Например, драйвер может определить один набор состояний производительности для управления частотой часов для компонента. Однако некоторым драйверам может потребоваться определить несколько наборов состояний производительности для управления несколькими измерениями состояний производительности для компонента. Например, драйвер может определить два набора состояний производительности для управления тактовой частотой и пропускной способностью шины.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается начиная с Windows 10. |
| Верхняя часть | wdm.h (включая Wudfwdm.h) |