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 |
---|---|
|
PEP_PLATFORM_IDLE_STATE_UPDATE 구조의 버전 번호는 지원되는 값이 아닙니다. |
|
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_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE