다음을 통해 공유

POFXCALLBACKUPDATEPROCESSORIDLESTATE 콜백 함수(pepfx.h)

  • 아티클

UpdateProcessorIdleState 루틴은 지정된 프로세서 유휴 상태의 속성을 업데이트하기 위해 PEP(플랫폼 확장 플러그 인)에서 호출됩니다.

통사론

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}

매개 변수

[in] ProcessorHandle

Windows PoFx(전원 관리 프레임워크)를 사용하여 프로세서를 디바이스로 등록하는 것을 나타내는 POHANDLE 값입니다. PEP는 이전에 프로세서가 PoFx에 등록되었음을 PEP에 알린 PEP_DPM_REGISTER_DEVICE 알림 중에 PoFx에서 이 핸들을 받았습니다.

[in] ProcessorState

속성을 업데이트할 프로세서 유휴 상태를 식별하는 인덱스입니다. 이전 PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 알림에 대한 응답으로 PEP는 지원되는 프로세서 유휴 상태의 수와 이러한 상태의 속성을 지정했습니다. PEP가 N 프로세서 유휴 상태를 지정한 경우 유효한 프로세서 유휴 상태 인덱스는 0에서 N-1까지입니다.

[in] Update

프로세서 유휴 상태의 업데이트된 속성을 포함하는 PEP_PROCESSOR_IDLE_STATE_UPDATE 구조체에 대한 포인터입니다.

반환 값

UpdateProcessorIdleState 프로세서 유휴 상태의 속성을 성공적으로 업데이트하면 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.

반환 값 묘사
STATUS_NOT_SUPPORTED
 PEP_PROCESSOR_IDLE_STATE_UPDATE 구조체의 버전 번호는 지원되는 값이 아닙니다.
STATUS_NOT_IMPLEMENTED
 UpdateProcessorIdleState 루틴은 이 프로세서에 대해 구현되지 않습니다.

발언

이 루틴은 PoFx에 의해 구현되며 PEP에 의해 호출됩니다. PEP_KERNEL_INFORMATION_STRUCT_V3 구조체의 UpdateProcessorIdleState 멤버는 UpdateProcessorIdleState 루틴에 대한 포인터입니다.

UpdateProcessorIdleState 루틴은 IRQL = PASSIVE_LEVEL 호출해야 합니다.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows 10부터 지원됩니다.
대상 플랫폼 Windows
헤더 pepfx.h(Pep_x.h 포함)
IRQL PASSIVE_LEVEL

참고 항목

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE