PoFxQueryCurrentComponentPerfState 함수(wdm.h)

  • 아티클

PoFxQueryCurrentComponentPerfState 루틴은 구성 요소의 성능 상태 집합에서 활성 성능 상태를 검색합니다.

구문

NTSTATUS PoFxQueryCurrentComponentPerfState(
  [in] POHANDLE   Handle,
  [in] ULONG      Flags,
  [in] ULONG      Component,
  [in] ULONG      SetIndex,
  [in] PULONGLONG CurrentPerf
);

매개 변수

[in] Handle

PoFx(전원 관리 프레임워크)를 사용하여 디바이스 등록을 나타내는 핸들입니다. 디바이스 드라이버는 이전에 PoFxRegisterDevice 루틴에서 이 핸들을 받았습니다.

[in] Flags

0으로 설정합니다. 현재 이 루틴에는 플래그가 정의되어 있지 않습니다.

[in] Component

성능 상태가 검색되는 구성 요소를 식별하는 인덱스입니다. 이 매개 변수는 디바이스 드라이버가 PoFx에 디바이스를 등록하는 데 사용한 PO_FX_DEVICE 구조의 Components 배열에 대한 인덱스입니다. Components 배열에 N 요소가 포함된 경우 구성 요소 인덱스의 범위는 0에서 N-1까지입니다.

[in] SetIndex

성능이 쿼리되는 성능 상태 집합을 식별하는 인덱스입니다. 이 매개 변수는 디바이스 드라이버가 PoFx에 구성 요소 성능 상태를 등록하는 데 사용한 PO_FX_COMPONENT_PERF_INFO 구조의 PerfStateSets 배열에 대한 인덱스입니다. PerfStateSets 배열에 N 요소가 포함된 경우 성능 상태 집합 인덱스는 0에서 N-1까지입니다.

[in] CurrentPerf

지정된 성능 상태 집합의 현재 성능 상태가 반환되는 변수에 대한 포인터입니다. 반환되는 값에 대한 자세한 내용은 비고를 참조하세요.

반환 값

요청한 작업이 성공하면 PoFxQueryCurrentComponentPerfState가 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 호출자가 구성 요소 또는 구성 요소 상태 집합에 대해 잘못된 인덱스 를 제공했습니다.

설명

드라이버는 PoFxQueryCurrentComponentPerfState 루틴을 호출하여 구성 요소에 대해 설정된 지정된 성능 상태의 현재 성능 상태를 검색할 수 있습니다. 호출이 성공하면 CurrentPerf 매개 변수는 집합의 현재 성능 상태를 지정하는 값에 대한 포인터로 덮어씁니다. 이 값은 드라이버가 PoFxRegisterComponentPerfStates 루틴에 전달한 PO_FX_COMPONENT_PERF_SET 구조체의 내용에 따라 다음 중 하나일 수 있습니다.

  • 성능 상태의 연속 분포를 나타내는 성능 상태 집합의 경우 이 값은 PO_FX_COMPONENT_PERF_SET 구조체의 최소 및 최대 멤버 사이의 값입니다.
  • 개별 성능 상태 수를 나타내는 성능 상태 집합의 경우 이 값은 PO_FX_COMPONENT_PERF_SET 구조의 States 멤버에 대한 인덱스입니다.
이 호출은 항상 동기적으로 실행됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 사용하여 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wdm.h
라이브러리 Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

추가 정보

디바이스 성능 상태 관리

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates