POFXCALLBACKUPDATEPROCESSORIDLESTATE 콜백 함수(pep_x.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 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.

반환 값 Description
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
헤더 pep_x.h(Pep_x.h 포함)
IRQL PASSIVE_LEVEL

추가 정보

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE