Freigeben über


PoFxRegisterPluginEx-Funktion (pepfx.h)

Die PoFxRegisterPluginEx Routine registriert ein Plattformerweiterungs-Plug-In (PEP) mit dem Windows Power Management Framework (PoFx).

Syntax

NTSTATUS PoFxRegisterPluginEx(
  [in]      PPEP_INFORMATION        PepInformation,
  [in]      ULONGLONG               Flags,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Parameter

[in] PepInformation

Ein Zeiger auf eine PEP_INFORMATION Struktur, die Zeiger auf eine oder mehrere Rückrufroutinen enthält, die vom PEP implementiert werden. Diese Routinen behandeln Benachrichtigungen, die von PoFx an den PEP gesendet werden.

[in] Flags

Eine Reihe von Flagbits zum Konfigurieren der PEP-Schnittstelle. Legen Sie dieses Element auf Null oder auf den folgenden Wert fest.

Flagbit Beschreibung
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

Ein Zeiger auf eine PEP_KERNEL_INFORMATION Struktur.

Rückgabewert

PoFxRegisterPluginEx gibt STATUS_SUCCESS zurück, wenn der Aufruf den PEP erfolgreich registriert. Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.

Rückgabewert Beschreibung
STATUS_INVALID_PARAMETER
Die Version oder Size Member der PEP_KERNEL_INFORMATION-Struktur wird auf einen ungültigen Wert festgelegt; oder das AcceptDeviceNotification Member dieser Struktur auf NULL festgelegt ist.
STATUS_INVALID_PEP_INFO_VERSION
Der Version Member der PEP_INFORMATION-Struktur wird auf einen ungültigen Wert festgelegt.
STATUS_INSUFFICIENT_RESOURCES
Die zum Abschließen der angeforderten Registrierung erforderlichen Ressourcen können nicht zugeordnet werden.

Bemerkungen

Ein PEP ruft diese Routine auf, sich bei PoFx zu registrieren.

Eine PEP kann die Registrierung nicht aufheben und kann nicht zweimal registriert werden. Wenn der PEP gewartet werden muss, muss das Betriebssystem neu gestartet werden.

Die PoFxRegisterPlugin- Routine ähnelt PoFxRegisterPluginEx-, mit der Ausnahme, dass kein Flags Parameter verwendet wird.

Der PEP muss PoFxRegisterPluginEx unter IRQL = PASSIVE_LEVEL aufrufen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar ab Windows 10.
Zielplattform- Fenster
Header- pepfx.h (include Pep_x.h)
Library Ntoskrnl.lib
IRQL- PASSIVE_LEVEL

Siehe auch

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin