다음을 통해 공유

PoFxRegisterPluginEx 함수(pepfx.h)

  • 아티클

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

구문

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으로 설정하거나 다음 값으로 설정합니다.

플래그 비트 Description
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

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

반환 값

호출이 PEP를 성공적으로 등록하면 PoFxRegisterPluginEx는 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를 서비스해야 하는 경우 운영 체제를 다시 시작해야 합니다.

PoFxRegisterPlugin 루틴은 Flags 매개 변수를 사용하지 않는다는 점을 제외하고 PoFxRegisterPluginEx와 유사합니다.

PEP는 IRQL = PASSIVE_LEVEL PoFxRegisterPluginEx 를 호출해야 합니다.

요구 사항

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

추가 정보

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin