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:

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:

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

Weitere Informationen

DeRegisterOpRegionHandler