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 구조를 제공할 수 있습니다. PO_FX_COMPONENT_PERF_INFO 구조체의 PerfStateSets 멤버에는 지원되는 성능 상태를 나타내는 PO_FX_COMPONENT_PERF_SET 구조의 배열이 포함되어 있습니다.

대부분의 드라이버는 구성 요소당 단일 성능 상태 집합을 정의해야 합니다. 예를 들어 드라이버는 하나의 성능 상태 집합을 정의하여 구성 요소의 클록 빈도를 제어할 수 있습니다. 그러나 일부 드라이버는 구성 요소에 대한 여러 차원의 성능 상태를 제어하기 위해 둘 이상의 성능 상태 집합을 정의해야 할 수 있습니다. 예를 들어 드라이버는 클록 빈도 및 버스 대역폭을 제어하기 위해 두 가지 성능 상태 집합을 정의할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 부터 지원합니다.
머리글 wdm.h(Wudfwdm.h 포함)

추가 정보

디바이스 성능 상태 관리

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates