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.