Funzione PoFxRegisterPluginEx (pep_x.h)

Articolo
02/29/2024

La routine PoFxRegisterPluginEx registra un plug-in dell'estensione della piattaforma (PEP) con il framework di gestione power di Windows (PoFx).

Sintassi

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

Parametri

[in] PepInformation

Puntatore a una struttura PEP_INFORMATION che contiene puntatori a una o più routine di callback implementate dal PEP. Queste routine gestiscono le notifiche inviate a PEP by PoFx.

[in] Flags

Set di bit di flag per la configurazione dell'interfaccia PEP. Impostare questo membro su zero o sul valore seguente.

Flag bit	Descrizione
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

Puntatore a una struttura PEP_KERNEL_INFORMATION .

Valore restituito

PoFxRegisterPluginEx restituisce STATUS_SUCCESS se la chiamata registra correttamente il PEP. I valori restituiti degli errori possibili includono i codici di stato seguenti.

Valore restituito	Descrizione
STATUS_INVALID_PARAMETER	Il membro Version o Size della struttura PEP_KERNEL_INFORMATION è impostato su un valore non valido; o il membro AcceptDeviceNotification di questa struttura è impostato su NULL.
STATUS_INVALID_PEP_INFO_VERSION	Il membro Version della struttura PEP_INFORMATION è impostato su un valore non valido.
STATUS_INSUFFICIENT_RESOURCES	Impossibile allocare le risorse necessarie per completare la registrazione richiesta.

Commenti

Un PEP chiama questa routine per registrarsi con PoFx.

Un PEP non può annullare la registrazione e non può registrare due volte. Se il PEP deve essere serviced, il sistema operativo deve essere riavviato.

La routine PoFxRegisterPlugin è simile a PoFxRegisterPluginEx, ad eccezione del fatto che non accetta un parametro Flags.

Il PEP deve chiamare PoFxRegisterPluginEx in IRQL = PASSIVE_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 10.
Piattaforma di destinazione	Windows
Intestazione	pep_x.h (includere Pep_x.h)
Libreria	Ntoskrnl.lib
IRQL	PASSIVE_LEVEL

Vedi anche

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin

Condividi tramite