PoFxRegisterCoreDevice 함수(pep_x.h)

  • 아티클

PoFxRegisterCoreDevice 루틴은 새 핵심 시스템 리소스를 PoFx(Windows 전원 관리 프레임워크)에 등록합니다.

구문

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

매개 변수

[in] Id

핵심 시스템 리소스를 고유하게 식별하는 문자열입니다. 이 멤버는 디바이스 식별 문자열을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[in] Device

핵심 시스템 리소스의 전원 특성을 설명하는 PO_FX_CORE_DEVICE 구조체에 대한 포인터입니다.

[out] Handle

루틴이 POHANDLE 값을 쓰는 위치에 대한 포인터입니다. 이 핸들은 PoFx를 사용하여 핵심 시스템 리소스의 등록을 나타냅니다.

반환 값

호출이 PEP를 성공적으로 등록하면 PoFxRegisterCoreDevice가 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.

반환 값 Description
STATUS_INVALID_PARAMETER
 이 디바이스의 구성 요소 수가 0이거나 PO_FX_CORE_DEVICE 구조에 잘못된 버전 번호가 포함되어 있거나 이 구조체의 ComponentCriticalTransitionCallback 멤버에 잘못된 함수 포인터가 포함되어 있습니다.
STATUS_INSUFFICIENT_RESOURCES
 요청된 등록을 완료하는 데 필요한 리소스를 할당할 수 없습니다.

설명

이 루틴은 이 리소스가 PoFx에서 전원을 관리할 수 있도록 핵심 시스템 리소스를 등록합니다.

핵심 시스템 리소스는 WINDOWS HAL(하드웨어 추상화 계층)에서 관리하는 타이머 및 인터럽트 컨트롤러와 같은 하드웨어 디바이스입니다. 이러한 디바이스는 운영 체제에 필요한 기본 기능을 제공합니다. 핵심 시스템 리소스와 프로세서 간의 긴밀한 관계로 인해 이러한 리소스의 전원 관리는 프로세서 유휴 상태 관리와 조정되어야 합니다.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 시작해서 사용할 수 있습니다.
대상 플랫폼 Windows
헤더 pep_x.h(Pep_x.h 포함)
라이브러리 Ntoskrnl.lib
IRQL PASSIVE_LEVEL

추가 정보

PO_FX_CORE_DEVICE

UNICODE_STRING