PEP_QUERY_COMPONENT_PERF_SET_NAME 구조체(pep_x.h)

아티클
02/26/2024

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

구문

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

멤버

[in] DeviceHandle

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

[in] Component

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

[in] Set

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

[in, NameSize

입력에서 Name 멤버가 가리키는 버퍼의 크기(바이트)입니다. Name이 NULL인 경우 PEP는 NameSize의 입력 값을 이름 문자열에 필요한 버퍼 크기로 덮어씁니다.

[in] Name

출력 버퍼에 대한 포인터입니다. PEP는 P 상태의 이름을 이 버퍼에 씁니다. 이름은 null로 끝나는 와이드 문자 문자열로 저장됩니다. Name 멤버는 Windows PoFx(전원 관리 프레임워크)가 이름 문자열에 할당할 버퍼의 수를 결정해야 하는 경우 NULL입니다. Name이 NULL이 아닌 경우 버퍼는 종결 null 문자를 포함하여 전체 문자열을 포함할 수 있을 만큼 커야 합니다.

설명

이 구조는 PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME 알림에서 사용됩니다. 이 알림을 보낼 때 구조체의 DeviceHandle, Component 및 Set 멤버에는 PoFx에서 제공하는 입력 값이 포함됩니다. Name 멤버가 NULL이 아닌 경우 PEP는 Name이 가리키는 버퍼에 문자열을 씁니다. Name이 NULL인 경우 PEP는 필요한 버퍼 크기를 NameSize 멤버에 씁니다.

PEP가 출력 버퍼에 쓰는 문자열에는 P 상태 집합에 대한 설명이 포함된 이름이 포함되어야 합니다. 이 이름은 로그 항목 및 진단 메시지를 더 쉽게 이해할 수 있도록 하기 위한 것입니다.