PoFxRegisterCoreDevice-Funktion (pepfx.h)

  • Artikel

Die PoFxRegisterCoreDevice-Routine registriert eine neue Kernsystemressource mit dem Windows Power Management Framework (PoFx).

Syntax

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

Parameter

[in] Id

Eine Zeichenfolge, die die Kernsystemressource eindeutig identifiziert. Dieses Element ist ein Zeiger auf eine UNICODE_STRING Struktur, die eine Geräteidentifikationszeichenfolge enthält.

[in] Device

Ein Zeiger auf eine PO_FX_CORE_DEVICE-Struktur , die die Leistungsmerkmale der Kernsystemressource beschreibt.

[out] Handle

Ein Zeiger auf einen Speicherort, an den die Routine einen POHANDLE-Wert schreibt. Dieses Handle stellt die Registrierung der Kernsystemressource bei PoFx dar.

Rückgabewert

PoFxRegisterCoreDevice gibt STATUS_SUCCESS zurück, wenn der Aufruf den PEP erfolgreich registriert. Mögliche Fehlerrückgabewerte umfassen die folgenden status-Codes.

Rückgabewert BESCHREIBUNG
STATUS_INVALID_PARAMETER
 Die Komponentenanzahl für dieses Gerät ist 0, oder die PO_FX_CORE_DEVICE-Struktur enthält eine ungültige Versionsnummer, oder das ComponentCriticalTransitionCallback-Element dieser Struktur enthält einen ungültigen Funktionszeiger.
STATUS_INSUFFICIENT_RESOURCES
 Die ressourcen, die zum Abschließen der angeforderten Registrierung erforderlich sind, können nicht zugeordnet werden.

Hinweise

Diese Routine registriert eine Kernsystemressource, sodass diese Ressource von PoFx verwaltet werden kann.

Kernsystemressourcen sind Hardwaregeräte wie Timer und Interruptcontroller, die von der Windows-Hardwareabstraktionsebene (HAL) verwaltet werden. Diese Geräte bieten grundlegende Funktionen, die vom Betriebssystem benötigt werden. Aufgrund der engen Beziehung zwischen Kernsystemressourcen und Prozessoren muss die Energieverwaltung dieser Ressourcen mit der Verwaltung des Prozessor-Leerlaufzustands koordiniert werden.

Die PoFxRegisterCoreDevice-Routine sollte unter IRQL = PASSIVE_LEVEL aufgerufen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 10.
Zielplattform Windows
Kopfzeile pepfx.h (einschließlich Pep_x.h)
Bibliothek Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

PO_FX_CORE_DEVICE

UNICODE_STRING