RegisterOpRegionHandler-Funktion (oprghdlr.h)
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 |