PoFxRegisterPlugin 함수(pep_x.h)

PoFxRegisterPlugin 루틴은 PEP(플랫폼 확장 플러그 인)를 PoFx(Windows 전원 관리 프레임워크)에 등록합니다.

구문

NTSTATUS PoFxRegisterPlugin(
  [in]      PPEP_INFORMATION        PepInformation,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

[in] PepInformation

PEP_INFORMATION 구조체에 대한 포인터입니다.

[in, out] KernelInformation

PEP_KERNEL_INFORMATION_STRUCT_V3 구조체에 대한 포인터입니다.

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

반환 값	Description
STATUS_INVALID_PARAMETER	PEP_KERNEL_INFORMATION 구조체의 Version 또는 Size 멤버가 잘못된 값으로 설정되었습니다. 또는 이 구조체의 AcceptDeviceNotification 멤버가 NULL로 설정됩니다.
STATUS_INVALID_PEP_INFO_VERSION	PEP_INFORMATION 구조체의 Version 멤버가 잘못된 값으로 설정되었습니다.
STATUS_INSUFFICIENT_RESOURCES	요청된 등록을 완료하는 데 필요한 리소스를 할당할 수 없습니다.

PEP는 이 루틴을 호출하여 PoFx에 등록합니다.

PEP는 등록을 취소할 수 없으며 두 번 등록할 수 없습니다. PEP를 서비스해야 하는 경우 운영 체제를 다시 시작해야 합니다.

PoFxRegisterPluginEx 루틴은 추가 매개 변수인 Flags를 사용한다는 점을 제외하고 PoFxRegisterPlugin과 유사합니다.

PEP는 IRQL = PASSIVE_LEVEL PoFxRegisterPlugin 을 호출해야 합니다.