ACPI_OP_REGION_HANDLER Rückruffunktion (oprghdlr.h)

Eine ACPI_OP_REGION_HANDLER typisierte Routine wird von einem ACPI-Gerätefunktionstreiber bereitgestellt, um den Zugriff des ACPI-Treibers 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:

Zugriffstyp	BESCHREIBUNG
ACPI_OPREGION_WRITE	Schreiben Sie in den Speicherpuffer der Vorgangsregion.
ACPI_OPREGION_READ	Lesen aus dem Speicherpuffer der Vorgangsregion.

OperationRegionObject

Gibt das Vorgangsregionobjekt an, das von RegisterOpRegionHandler für den Vorgangsregionshandler zurückgegeben wird.

Address

Gibt einen Byteoffset im Speicherpuffer der Vorgangsregion an. Je nach Zugriffstyp werden Daten an diesen Speicherspeicherort oder von diesem übertragen.

Size

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

Data

Zeiger auf den Datenpuffer, der vom ACPI-Treiber bereitgestellt wird, der dem Zugriff zugeordnet ist. Für einen Lesezugriff werden Bytes aus dem Speicherpuffer der Vorgangsregion in den Datenpuffer übertragen. Für einen Schreibzugriff werden Bytes aus dem Datenpuffer in den Speicherpuffer der Vorgangsregion übertragen.

Context

Zeiger auf denselben Vorgangsregionskontext, den der Funktionstreiber beim Registrieren des Vorgangsregionshandlers angegeben hat.

CompletionHandler

Für die interne Verwendung reserviert.

CompletionContext

Für die interne Verwendung reserviert.

Rückgabewert

Gibt einen der folgenden status Werte zurück:

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

Hinweise

Wenn der ACPI-Treiber einen Vorgangsregionenhandler aufruft, gibt er Werte für Adresse und Größe an, die sicherstellen, dass sich der Zugriff innerhalb der Vorgangsregion befindet, die im ACPI-BIOS für das ACPI-Gerät definiert ist. Der ACPI-Gerätefunktionstreiber muss sicherstellen, dass der speicherzuteilende Speicherpuffer der Vorgangsregion mindestens so groß (in Bytes) ist wie die für das ACPI-Gerät definierte Vorgangsregion.

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

Eine ACPI_OP_REGION_HANDLER typisierte Routine wird am IRQL des Aufrufers ausgeführt.

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

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	oprghdlr.h (include Oprghdlr.h)

Weitere Informationen

DeRegisterOpRegionHandler