ACPI_OP_REGION_HANDLER Rückruffunktion (oprghdlr.h)

Artikel
02/07/2025

Eine ACPI_OP_REGION_HANDLER typierte Routine wird von einem ACPI-Gerätefunktionstreiber bereitgestellt, um den Zugriff durch den ACPI-Treiber auf die Betriebsregion des Geräts zu ermöglichen.

Syntax

ACPI_OP_REGION_HANDLER AcpiOpRegionHandler;

NTSTATUS AcpiOpRegionHandler(
  ULONG AccessType,
  PVOID OperationRegionObject,
  ULONG Address,
  ULONG Size,
  PULONG Data,
  ULONG_PTR Context,
  PACPI_OP_REGION_CALLBACK CompletionHandler,
  PVOID CompletionContext
)
{...}

Parameter

AccessType

Gibt einen der folgenden Zugriffstypen an:

Access-Typ	Beschreibung
ACPI_OPREGION_WRITE	Schreiben in den Speicherpuffer des Vorgangsbereichs.
ACPI_OPREGION_READ	Lesen aus dem Speicherpuffer des Vorgangsbereichs.

OperationRegionObject

Gibt das vorgangsbereichsobjekt an, das von RegisterOpRegionHandler für den Vorgangsbereichshandler zurückgegeben wird.

Address

Gibt einen Byte-Offset im Speicherpuffer des Vorgangsbereichs an. Je nach Zugriffstyp werden Daten an diesen Speicherort übertragen oder von diesem Speicherort.

Size

Gibt die Anzahl der Bytes an, auf die zugegriffen werden soll.

Data

Zeigen Sie auf den vom ACPI-Treiber bereitgestellten Datenpuffer, der dem Zugriff zugeordnet ist. Für einen Lesezugriff werden Bytes aus dem Speicherpuffer des Vorgangsbereichs in den Datenpuffer übertragen. Für einen Schreibzugriff werden Bytes aus dem Datenpuffer in den Speicherpuffer des Vorgangsbereichs übertragen.

Context

Zeigen Sie auf denselben Vorgangsbereichskontext, den der Funktionstreiber beim Registrieren des Vorgangsbereichshandlers angegeben hat.

CompletionHandler

Reserviert für die interne Verwendung.

CompletionContext

Reserviert für die interne Verwendung.

Rückgabewert

Gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Zugriff war erfolgreich.
STATUS_INVALID_DEVICE_REQUEST	Der Zugriffstyp ist ungültig.
STATUS_Xxx	Interner Fehler.

Bemerkungen

Wenn der ACPI-Treiber einen Vorgangsregionenhandler aufruft, gibt er Werte für Address und Size an, um sicherzustellen, dass sich der Zugriff in der Vorgangsregion befindet, die im ACPI-BIOS für das ACPI-Gerät definiert ist. Der ACPI-Gerätefunktionstreiber muss sicherstellen, dass der zugeordnete Speicherpuffer des Vorgangsbereichs mindestens so groß wie in Bytes ist, wie die für das ACPI-Gerät definierte Vorgangsregion.

Weitere Informationen zu Vorgangsbereichshandlern finden Sie unter Unterstützen eines Vorgangsbereichs.

Eine ACPI_OP_REGION_HANDLER typisierende Routine wird im IRQL des Aufrufers ausgeführt.

Ausführliche Informationen zu Einschränkungen für Betriebsregionen finden Sie in der Advanced Configuration and Power Interface (ACPI)-Spezifikation.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	oprghdlr.h (include Oprghdlr.h)

Siehe auch

DeRegisterOpRegionHandler-

Freigeben über