PEP_COMPONENT_PERF_SET 구조체(pep_x.h)

  • 아티클

PEP_COMPONENT_PERF_SET 구조체는 P 상태 집합의 성능 상태(P 상태)를 설명합니다.

구문

typedef struct _PEP_COMPONENT_PERF_SET {
  UNICODE_STRING      Name;
  ULONGLONG           Flags;
  PEP_PERF_STATE_UNIT Unit;
  PEP_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG           Count;
      PPEP_PERF_STATE States;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;

멤버

Name

이 P 상태 집합에 의해 제어되는 디바이스 속성을 설명하는 선택적 문자열입니다. 예를 들어 이 문자열은 "클록 빈도" 또는 "메모리 대역폭"일 수 있습니다. 이 P 상태에 사용할 수 있는 문자열이 없으면 Name 멤버가 NULL로 설정됩니다. 그렇지 않으면 이 멤버는 문자열을 포함하는 UNICODE_STRING 구조체에 대한 포인터를 포함합니다.

Flags

0으로 설정됩니다. 현재 이 멤버에 대해 플래그 비트가 정의되어 있지 않습니다.

Unit

이 P 상태 집합의 성능 값이 표현되는 단위를 지정하는 PEP_PERF_STATE_UNIT 구조체입니다. 구성 요소 성능은 헤르츠(빈도) 또는 초당 비트(대역폭)로 표현할 수 있습니다.

Type

이 구성 요소에 대해 지정된 성능 정보의 유형을 나타내는 PEP_PERF_STATE_TYPE 열거형 값입니다. 이 멤버는 이 P 상태 집합의 성능 값이 불연속 값 목록 또는 연속 값 범위로 지정되는지 여부를 나타냅니다.

Discrete

이 P 상태 집합에 대한 불연속 성능 값 목록입니다.

Discrete.Count

이 P 상태 집합의 P 상태 수입니다.

Discrete.States

PEP_PERF_STATE 구조체 배열에 대한 포인터로, 각각 이 P 상태 집합의 불연속 성능 값을 설명합니다. Count 멤버는 이 배열의 요소 수를 지정합니다. P 상태는 배열 인덱스로 식별됩니다. 배열에 N 요소가 포함된 경우 P 상태 인덱스의 범위는 0에서 N-1까지입니다.

Range

이 P 상태 집합에 대한 불연속 성능 측정 값의 범위입니다.

Range.Minimum

범위의 최소값입니다. 이 값은 Unit 멤버가 나타내는 단위로 표현됩니다.

Range.Maximum

범위의 최대값입니다. 이 값은 Unit 멤버가 나타내는 단위로 표현됩니다.

설명

명명되지 않은 공용 구조체에는 이 P 상태에 대한 성능 측정 값이 포함됩니다. 이 공용 구조체에는 불연속 값 목록(if Type == PepPerfStateTypeDiscrete) 또는 연속 값 범위(있는 경우 Type == PepPerfStateTypeRange)가 포함됩니다.

PEP_COMPONENT_PERF_INFOPerfStateSets 멤버는 PEP_COMPONENT_PERF_SET 구조체 배열의 첫 번째 요소입니다. PEP_COMPONENT_PERF_SET 구조체의 모든 멤버에는 Windows PoFx(전원 관리 프레임워크)에서 제공하는 입력 값이 포함됩니다. PEP(플랫폼 확장 플러그 인)는 이 구조에 쓸 수 없습니다.

디바이스 드라이버는 PEP_COMPONENT_PERF_SET 구조와 유사한 PO_FX_COMPONENT_PERF_SET 구조를 사용합니다.

요구 사항

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

추가 정보