POFXCALLBACKUPDATEPLATFORMIDLESTATE 콜백 함수(pepfx.h)

  • 아티클

UpdatePlatformIdleState 루틴은 PEP(플랫폼 확장 플러그 인)에서 호출되어 지정된 플랫폼 유휴 상태의 속성을 업데이트합니다.

구문

POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;

NTSTATUS Pofxcallbackupdateplatformidlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}

매개 변수

[in] ProcessorHandle

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

[in] PlatformState

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

[in] Update

플랫폼 유휴 상태의 업데이트된 속성을 포함하는 PEP_PLATFORM_IDLE_STATE_UPDATE 구조체에 대한 포인터입니다.

반환 값

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

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

설명

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

PEP는 UpdatePlatformIdleState 루틴을 호출하기 위해 모든 PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE 알림을 완료할 때까지 기다려야 합니다.

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

요구 사항

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

추가 정보

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE