Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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äteidentifikationszeichenfolgeenthält.
[in] Device
Ein Zeiger auf eine PO_FX_CORE_DEVICE Struktur, die die Leistungsmerkmale der Kernsystemressource beschreibt.
[out] Handle
Ein Zeiger auf eine Position, an die 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 Anruf den PEP erfolgreich registriert. Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.
| Rückgabewert | Beschreibung |
|---|---|
|
Die Komponentenanzahl für dieses Gerät ist null, oder die PO_FX_CORE_DEVICE-Struktur enthält eine ungültige Versionsnummer, oder das ComponentCriticalTransitionCallback Member dieser Struktur enthält einen ungültigen Funktionszeiger. |
|
Die zum Abschließen der angeforderten Registrierung erforderlichen Ressourcen können nicht zugeordnet werden. |
Bemerkungen
Diese Routine registriert eine Kernsystemressource, sodass diese Ressource von PoFx verwaltet werden kann.
Kernsystemressourcen sind Hardwaregeräte, z. B. Timer 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 Prozessor-Leerlaufzustandsverwaltung koordiniert werden.
Die PoFxRegisterCoreDevice Routine sollte bei IRQL = PASSIVE_LEVEL aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 10. |
| Zielplattform- | Fenster |
| Header- | pep_x.h (einschließen Pep_x.h) |
| Library | Ntoskrnl.lib |
| IRQL- | PASSIVE_LEVEL |