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