ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX-Struktur (acpiioct.h)
Die ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX-Struktur wird als Eingabe für eine IOCTL_ACPI_EVAL_METHOD_EX Anforderung und für eine IOCTL_ACPI_ASYNC_EVAL_METHOD_EX-Anforderung verwendet. Die -Struktur stellt den Pfad und den Namen einer Steuerungsmethode in einem ACPI-Namespace und ein Eingabeargumentarray aus ACPI_METHOD_ARGUMENT-Strukturen bereit.
Syntax
typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG Size;
ULONG ArgumentCount;
ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;
Member
Signature
Die Signatur eines erweiterten komplexen Eingabepuffers, der auf ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX festgelegt werden muss.
MethodName[256]
Eine MIT NULL beendete ASCII-Zeichenfolge, die den Pfad und den Namen einer Steuerelementmethode in einem ACPI-Namespace enthält. Die maximale Anzahl von Zeichen, die die Zeichenfolge enthalten kann, einschließlich eines NULL-Abschlusszeichens, beträgt 256.
Weitere Informationen zum Angeben des Pfads und des Namens einer Steuerelementmethode finden Sie im Abschnitt Hinweise weiter unten in diesem Thema.
Size
Die Anzahl der Bytes, die das Argumentarray enthält.
ArgumentCount
Die Anzahl der ACPI_METHOD_ARGUMENT Strukturen, die das Argumentarray enthält. Das Argumentarray kann maximal sieben Argumentstrukturen enthalten.
Argument[ANYSIZE_ARRAY]
Ein Array von ACPI_METHOD_ARGUMENT Strukturen.
Hinweise
Ein Treiber für ein Gerät kann eine IOCTL_ACPI_EVAL_METHOD_EX-Anforderung oder eine IOCTL_ACPI_ASYNC_EVAL_METHOD_EX-Anforderung verwenden, um eine Steuerungsmethode auszuwerten, die ein untergeordnetes untergeordnetes Objekt des Geräts ist. Wenn die Methode ein komplexes Array von Argumenten akzeptiert, wird für diese Anforderungen eine Eingabe ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX Struktur wie folgt verwendet:
- Legen Sie Signatur auf ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX fest.
-
Legen Sie MethodName auf eine NULL-beendete Zeichenfolge fest, die entweder den vollständigen Pfad und namen einer Steuerelementmethode im ACPI-Namespace oder den Pfad und Namen der Methode relativ zum Gerät bereitstellt, an das die Auswertungsanforderung gesendet wird.
Angenommen, eine Anforderung wird an ein Gerät namens "ABCD" gesendet, das ein unmittelbares untergeordnetes Element des Stammes eines ACPI-Namespace ist, dass das "ABCD"-Gerät ein untergeordnetes Gerät mit dem Namen "CHLD" unterstützt und dass das "CHLD"-Gerät eine Methode mit dem Namen "_FOO" unterstützt. In diesem Fall kann die Auswertungsanforderung entweder "\ABCD" bereitstellen. CHLD._FOO" ist der vollqualifizierte Pfad und Name der Steuerungsmethode im ACPI-Namespace oder "CHLD._FOO", wobei es sich um den Pfad und den Namen der Steuerungsmethode handelt, die relativ zum "ABCD"-Gerät im ACPI-Namespace ist.
Weitere Informationen zum Abrufen des vollqualifizierten Pfads und namens einer Steuerelementmethode in einem ACPI-Namespace finden Sie unter Aufzählen untergeordneter Geräte und Steuerungsmethoden.
- Die Größe wird auf die Anzahl der Bytes im Argumentarray festgelegt.
- ArgumentCount ist auf die Anzahl der Argumente im Argumentarray festgelegt.
- Argument wird auf ein Array von ACPI_METHOD_ARGUMENT Strukturen festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista und höhere Versionen von Windows. |
| Kopfzeile | acpiioct.h (include Acpiioct.h) |