PEP_QUERY_COMPONENT_PERF_SET 구조체(pepfx.h)

  • 아티클

PEP_QUERY_COMPONENT_PERF_SET 구조에는 구성 요소의 성능 상태 값 집합(P 상태 집합)에 대한 쿼리 정보가 포함되어 있습니다.

구문

typedef struct _PEP_QUERY_COMPONENT_PERF_SET {
  PEPHANDLE           DeviceHandle;
  ULONG               Component;
  ULONG               Set;
  ULONGLONG           Flags;
  PEP_PERF_STATE_UNIT Unit;
  PEP_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG Count;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;

멤버

DeviceHandle

디바이스를 식별하는 PEPHANDLE 값입니다. PEP는 이전 PEP_DPM_REGISTER_DEVICE 알림에 대한 응답으로 이 핸들을 제공했습니다.

Component

구성 요소를 식별하는 인덱스입니다. 이 멤버는 PEP가 이 디바이스에 대한 PEP_DPM_REGISTER_DEVICE 알림에 대한 응답으로 이전에 제공한 PEP_DEVICE_REGISTER_V2 구조의 구성 요소 배열에 대한 인덱스입니다. Components 배열에 N 요소가 포함된 경우 구성 요소 인덱스는 0에서 N-1까지입니다.

Set

이 P 상태 집합을 식별하는 인덱스입니다. 이 구성 요소에 M P 상태 집합이 있는 경우 P 상태 집합 인덱스는 0에서 M-1까지입니다. PEP는 이전에 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 알림에 대한 응답으로 P 상태 집합 수를 지정했습니다.

Flags

입력 플래그 집합입니다. 현재 이 멤버에 대해 정의된 플래그 비트는 없으며 항상 0입니다.

Unit

이 P 상태 집합의 값이 헤르츠(빈도 단위) 또는 초당 비트(대역폭 단위)로 표현되는지 여부를 나타내는 PEP_PERF_STATE_UNIT 열거형 값입니다.

Type

이 P 상태 집합의 성능 값이 불연속 값 목록 또는 연속 값 범위로 표현되는지 여부를 나타내는 PEP_PERF_STATE_TYPE 열거형 값입니다.

Discrete

인 경우 Type == PepPerfStateTypeDiscrete이 구조를 사용합니다.

Discrete.Count

이 P 상태 집합의 불연속 성능 값 수입니다.

Range

인 경우 Type == PepPerfStateTypeRange이 구조를 사용합니다.

Range.Minimum

이 P 상태 집합에 대한 성능 값 범위의 최소값입니다. 이 값은 단위 멤버가 나타내는 측정 단위로 표현됩니다.

Range.Maximum

이 P 상태 집합에 대한 성능 값 범위의 최대값입니다. 이 값은 단위 멤버가 나타내는 측정 단위로 표현됩니다.

설명

이 구조는 PEP_DPM_QUERY_COMPONENT_PERF_SET 알림에서 사용됩니다. DeviceHandle, Component, Set 및 Flags 멤버에는 이 알림을 보낼 때 Windows PoFx(전원 관리 프레임워크)에서 제공하는 입력 값이 포함됩니다. 불연속 멤버 또는 Range 멤버에는 PEP가 알림에 대한 응답으로 구조체에 쓰는 출력 값이 포함됩니다.

명명되지 않은 공용 구조체에는 이 P 상태 집합의 불연속 성능 값 수 또는 이 P 상태 집합의 값 범위가 포함됩니다.

요구 사항

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

추가 정보