PEP_QUERY_COMPONENT_PERF_STATES 구조체(pepfx.h)

아티클
08/07/2023

PEP_QUERY_COMPONENT_PERF_STATES 구조에는 지정된 P 상태 집합에 대한 불연속 성능 상태(P 상태) 값 목록이 포함되어 있습니다.

구문

typedef struct _PEP_QUERY_COMPONENT_PERF_STATES {
  [in] PEPHANDLE       DeviceHandle;
  [in] ULONG           Component;
  [in] ULONG           Set;
  [in] PPEP_PERF_STATE States;
} PEP_QUERY_COMPONENT_PERF_STATES, *PPEP_QUERY_COMPONENT_PERF_STATES;

멤버

[in] DeviceHandle

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

[in] Component

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

[in] Set

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

[in] States

출력 버퍼에 대한 포인터입니다. PEP는 이 버퍼에 PEP_PERF_STATE 구조체의 배열을 씁니다. 각 배열 요소는 Set 멤버가 지정한 P 상태 집합의 하나의 P 상태를 설명합니다. PoFx(Windows 전원 관리 프레임워크)는 이 버퍼를 할당했는데, 이는 PEP가 이전에 PEP_DPM_QUERY_COMPONENT_PERF_SET 알림에 대한 응답으로 PEP_QUERY_COMPONENT_PERF_SET 구조체의 Discrete.Count 멤버에 쓴 길이의 배열을 포함할 수 있을 만큼 충분히 커지도록 보장됩니다.