RegisterOpRegionHandler-Funktion (oprghdlr.h)

Artikel
02/29/2024

Die RegisterOpRegionHandler-Routine registriert einen Vorgangsregionshandler beim ACPI-Treiber.

Syntax

NTSTATUS RegisterOpRegionHandler(
  [in]  PDEVICE_OBJECT          DeviceObject,
  [in]  ULONG                   AccessType,
  [in]  ULONG                   RegionSpace,
  [in]  PACPI_OP_REGION_HANDLER Handler,
  [in]  PVOID                   Context,
  [in]  ULONG                   Flags,
  [out] PVOID                   *OperationRegionObject
);

Parameter

[in] DeviceObject

Zeiger auf das physische Geräteobjekt (PDO), das das ACPI-Gerät darstellt, das den Vorgangsbereich definiert.

[in] AccessType

Gibt ACPI_OPREGION_ACCESS_AS_COOKED an.

[in] RegionSpace

Gibt einen der folgenden Arten von Regionsraum an.

Regionsraumbezeichner	BESCHREIBUNG
ACPI_OPREGION_REGION_SPACE_MEMORY	Systemspeicher
ACPI_OPREGION_REGION_SPACE_IO	E/A-Speicherplatz
ACPI_OPREGION_REGION_SPACE_PCI_CONFIG	PCI-Konfiguration
ACPI_OPREGION_REGION_SPACE_EC	Eingebetteter Controller
ACPI_OPREGION_REGION_SPACE_SMB	Systemverwaltungsbus
ACPI_OPREGION_REGION_SPACE_CMOS_CONFIG	CMOS-Konfiguration
ACPI_OPREGION_REGION_SPACE_PCIBARTARGET	PCI-Basisadressregister
Vom Hersteller definierter Wert von 0x80 zu 0xFF	Herstellerdefinierte Geräte

[in] Handler

Zeiger auf den ACPI_OP_REGION_HANDLER typisierten Vorgangsregionshandler (bereitgestellt von einem ACPI-Gerätefunktionstreiber).

[in] Context

Zeiger auf einen gerätespezifischen Vorgangsregionskontext (bereitgestellt von einem ACPI-Gerätefunktionstreiber).

[in] Flags

Für die interne Verwendung reserviert.

[out] OperationRegionObject

Zeiger auf den vom Aufrufer zugewiesenen Puffer, der bei der Ausgabe einen Zeiger auf das Vorgangsregionobjekt enthält, das der ACPI-Treiber für die Vorgangsregion erstellt.

Rückgabewert

Gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Handler für die Betriebsregion wurde erfolgreich registriert.
STATUS_ACPI_INVALID_DATA	Die angegebenen Informationen sind ungültig.
STATUS_INSUFFICIENT_RESOURCES	Die Routine konnte die erforderlichen Systemressourcen nicht zuordnen.
STATUS_Xxx	Interner Fehler.

Hinweise

Der durch Context angegebene Vorgangsregionskontext ist gerätespezifisch und wird nur vom Funktionstreiber verwendet. In der Regel ist der Kontext die Geräteerweiterung für das funktionale Geräteobjekt (Functional Device Object, FDO). Der ACPI-Treiber übergibt diesen Kontext zurück an den Funktionstreiber, wenn er den Vorgangsregion-Handler aufruft. Das Vorgangsregionsobjekt wird nur von einem Funktionstreiber verwendet, um die Vorgangsregion eindeutig zu identifizieren, wenn die Registrierung des Vorgangsregionshandlers aufgehoben wird.

Weitere Informationen zu Vorgangsregionen finden Sie unter Unterstützen einer Vorgangsregion.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	oprghdlr.h (include Oprghdlr.h)
Bibliothek	Oprghdlr.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

ACPI_OP_REGION_HANDLER

DeRegisterOpRegionHandler

Share via