Freigeben über

PoFxRegisterCoreDevice-Funktion (pep_x.h)

  • Artikel

Die PoFxRegisterCoreDevice-Routine registriert eine neue Kernsystemressource beim 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. Dieser Member 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 pep erfolgreich registriert. Mögliche Fehlerrückgabewerte sind die folgenden status Codes.

Rückgabewert BESCHREIBUNG
STATUS_INVALID_PARAMETER
 Die Komponentenanzahl für dieses Gerät ist null, oder die PO_FX_CORE_DEVICE-Struktur enthält eine ungültige Versionsnummer, oder der ComponentCriticalTransitionCallback-Member 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 Zeitgeber und Interruptcontroller, die von der Windows-Hardwareabstraktionsebene (HAL) verwaltet werden. Diese Geräte stellen grundlegende Funktionen bereit, die vom Betriebssystem benötigt werden. Aufgrund der engen Beziehung zwischen Kernsystemressourcen und Prozessoren muss die Energieverwaltung dieser Ressourcen mit der Verwaltung des Prozessorzustands im Leerlauf koordiniert werden.

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

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

PO_FX_CORE_DEVICE

UNICODE_STRING