PoFxRegisterPlugin 함수(pepfx.h)
PoFxRegisterPlugin 루틴은 Windows PoFx(전원 관리 프레임워크)에 PEP(플랫폼 확장 플러그 인)를 등록합니다.
통사론
NTSTATUS PoFxRegisterPlugin(
[in] PPEP_INFORMATION PepInformation,
[in, out] PPEP_KERNEL_INFORMATION KernelInformation
);
매개 변수
[in] PepInformation
PEP_INFORMATION 구조체에 대한 포인터입니다.
[in, out] KernelInformation
PEP_KERNEL_INFORMATION_STRUCT_V3 구조체에 대한 포인터입니다.
반환 값
PoFxRegisterPlugin 호출이 PEP를 성공적으로 등록하면 STATUS_SUCCESS 반환합니다. 가능한 오류 반환 값에는 다음 상태 코드가 포함됩니다.
| 반환 값 | 묘사 |
|---|---|
| STATUS_INVALID_PARAMETER | PEP_KERNEL_INFORMATION 구조체의 버전 또는 Size 멤버가 잘못된 값으로 설정됩니다. 또는 이 구조체의 AcceptDeviceNotification 멤버가 NULL로 설정됩니다. |
| STATUS_INVALID_PEP_INFO_VERSION | PEP_INFORMATION 구조체의 Version 멤버가 잘못된 값으로 설정되었습니다. |
| STATUS_INSUFFICIENT_RESOURCES | 요청된 등록을 완료하는 데 필요한 리소스를 할당할 수 없습니다. |
발언
PEP는 이 루틴을 호출하여 PoFx에 등록합니다.
PEP는 등록을 취소할 수 없으며 두 번 등록할 수 없습니다. PEP를 서비스해야 하는 경우 운영 체제를 다시 시작해야 합니다.
PoFxRegisterPluginEx 루틴은 PoFxRegisterPlugin유사합니다. 단, 플래그 추가 매개 변수를 사용합니다.
PEP는 IRQL = PASSIVE_LEVEL PoFxRegisterPlugin 호출해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10부터 사용할 수 있습니다. |
| 대상 플랫폼 | Windows |
| 헤더 | pepfx.h(Pep_x.h 포함) |
| 라이브러리 | Ntoskrnl.lib |
| IRQL | PASSIVE_LEVEL |