Freigeben über


Eingabepufferstrukturen der Steuerelementmethode

Der ACPI-Treiber unterstützt die IOCTL_ACPI_EVAL_METHOD-Anforderung . Ein Treiber für ein Gerät kann diese Anforderung verwenden, um eine Steuerungsmethode auszuwerten, bei der es sich um ein unmittelbar untergeordnetes Objekt im ACPI-Namespace des Geräts handelt, an das die Anforderung gesendet wird. Die IOCTL_ACPI_EVAL_METHOD-Anforderung unterstützt die folgenden Eingabestrukturen:

Eingabestruktur BESCHREIBUNG
ACPI_EVAL_INPUT_BUFFER Gibt die Signatur des Puffers und den Namen einer Steuerelementmethode an, die kein Eingabeargument akzeptiert.
ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER Stellt die Signatur der Struktur, den Namen einer Steuerelementmethode und einen einzelnen Eingabeargumentwert vom Typ ULONG bereit.
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING Gibt die Signatur der Struktur, den Namen einer Steuerelementmethode und ein Eingabeargument an, bei dem es sich um eine NULL-beendete ASCII-Zeichenfolge handelt.
ACPI_EVAL_INPUT_BUFFER_COMPLEX Stellt die Signatur der Struktur, den Namen einer Steuerelementmethode und ein Eingabearray von ACPI_METHOD_ARGUMENT Strukturen bereit. Das Array kann eine maximale Anzahl von sieben solcher Strukturen enthalten. Eine ACPI_METHOD_ARGUMENT-Struktur kann eine ULONG-Ganzzahl, eine ASCII-Zeichenfolge, eine ACPI-Paketbeschreibung oder ein Array benutzerdefinierter Daten enthalten.

Windows unterstützt auch die IOCTL_ACPI_EVAL_METHOD_EX-Anforderung . Ein Treiber für ein Gerät kann diese Anforderung verwenden, um eine Steuerungsmethode auszuwerten, bei der es sich um ein untergeordnetes untergeordnetes Objekt im ACPI-Namespace des Geräts handelt, an das die Anforderung gesendet wird. Die IOCTL_ACPI_EVAL_METHOD_EX-Anforderung unterstützt die folgenden Eingabestrukturen:

Eingabestruktur BESCHREIBUNG
ACPI_EVAL_INPUT_BUFFER_EX gibt die Signatur der Struktur sowie den Pfad und namen einer Steuerelementmethode an, die kein Eingabeargument akzeptiert.
ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX gibt die Signatur der Struktur sowie den Pfad und namen einer Steuerelementmethode an, die eine einzelne ganze Zahl vom Typ ULONG64 als Eingabeargument akzeptiert.
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX stellt die Signatur der Struktur sowie den Pfad und Namen einer Steuerelementmethode bereit, die eine einzelne NULL-beendete ASCII-Zeichenfolge als Eingabeargument verwendet.
ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX gibt die Signatur der Struktur sowie den Pfad und den Namen einer Steuerelementmethode an, die ein Array von ACPI_METHOD_ARGUMENT Strukturen als Eingabe übernimmt. Das Array kann eine maximale Anzahl von sieben solcher Strukturen enthalten. Eine ACPI_METHOD_ARGUMENT Struktur kann eine ULONG-Ganzzahl, eine ASCII-Zeichenfolge, eine ACPI-Paketbeschreibung oder ein Array benutzerdefinierter Daten enthalten.

Um den Pfad und Namen untergeordneter Objekte im ACPI-Namespace eines Geräts abzurufen, kann ein Treiber für ein Gerät eine IOCTL_ACPI_ENUM_CHILDREN Anforderung verwenden, wie unter Aufzählen untergeordneter Geräte und Steuerungsmethoden beschrieben.