PoFxRegisterPluginEx-Funktion (pep_x.h)

  • Artikel

Die PoFxRegisterPluginEx-Routine registriert ein Plattformerweiterungs-Plug-In (PEP) beim 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 per PoFx an pep gesendet werden.

[in] Flags

Ein Satz von Flagbits zum Konfigurieren der PEP-Schnittstelle. Legen Sie diesen Member auf null oder auf den folgenden Wert fest.

Flag-Bit 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 pep erfolgreich registriert. Mögliche Fehlerrückgabewerte sind die folgenden status Codes.

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

Hinweise

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

Eine PEP kann die Registrierung nicht aufheben und sich nicht zweimal registrieren. Wenn pep gewartet werden muss, muss das Betriebssystem neu gestartet werden.

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

Der PEP muss PoFxRegisterPluginEx unter IRQL = PASSIVE_LEVEL aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Ab Windows 10 verfügbar.
Zielplattform Windows
Kopfzeile pep_x.h (Pep_x.h einschließen)
Bibliothek Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin