PoFxRegisterCoreDevice 함수(pepfx.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 등록을 나타냅니다.
반환 값
PoFxRegisterCoreDevice 호출이 PEP를 성공적으로 등록하면 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.
| 반환 값 | 묘사 |
|---|---|
|
이 디바이스의 구성 요소 수가 0이거나 PO_FX_CORE_DEVICE 구조에 잘못된 버전 번호가 포함되어 있거나 이 구조체의 ComponentCriticalTransitionCallback 멤버에 잘못된 함수 포인터가 포함되어 있습니다. |
|
요청된 등록을 완료하는 데 필요한 리소스를 할당할 수 없습니다. |
발언
이 루틴은 핵심 시스템 리소스를 등록하므로 PoFx에서 이 리소스를 전원으로 관리할 수 있습니다.
핵심 시스템 리소스는 WINDOWS HAL(하드웨어 추상화 계층)에서 관리하는 타이머 및 인터럽트 컨트롤러와 같은 하드웨어 디바이스입니다. 이러한 디바이스는 운영 체제에 필요한 기본 기능을 제공합니다. 핵심 시스템 리소스와 프로세서 간의 긴밀한 관계로 인해 이러한 리소스의 전원 관리는 프로세서 유휴 상태 관리와 조정되어야 합니다.
PoFxRegisterCoreDevice 루틴은 IRQL = PASSIVE_LEVEL 호출해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10부터 사용할 수 있습니다. |
| 대상 플랫폼 | Windows |
| 헤더 | pepfx.h(Pep_x.h 포함) |
| 라이브러리 | Ntoskrnl.lib |
| IRQL | PASSIVE_LEVEL |