ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX-Struktur (acpiioct.h)
Die ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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 liefert den Pfad und Namen einer Steuerelementmethode in einem ACPI-Namespace und ein Eingabeargument, das eine ASCII-Zeichenfolge ist.
Syntax
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG StringLength;
UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX;
Member
Signature
Die Signatur eines erweiterten Zeichenfolgeneingabepuffers, der auf ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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 namens einer Steuerelementmethode finden Sie weiter unten in diesem Thema im Abschnitt Hinweise.
StringLength
Die Anzahl der ASCII-Zeichen im Array von Zeichen, das von String bereitgestellt wird.
String[ANYSIZE_ARRAY]
Ein ASCII-Zeichenarray, das die Von StringLength angegebene Anzahl von Zeichen enthält. Das Zeichenarray enthält kein NULL-Abschlusszeichen.
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 Nachfolgerobjekt des Geräts ist. Wenn die -Methode ein einzelnes Zeichenfolgeneingabeargument akzeptiert, wird für diese Anforderungen eine Eingabe ACPI_EVAL_INPUT_BUFFER_STRING_EX Struktur wie folgt verwendet:
- Legen Sie Signatur auf ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX fest.
-
Legen Sie MethodName auf eine NULL-endende Zeichenfolge fest, die entweder den vollständigen Pfad und den Namen einer Steuerelementmethode im ACPI-Namespace oder den Pfad und Namen der Methode bereitstellt, die relativ zu dem Gerät ist, an das die Auswertungsanforderung gesendet wird.
Angenommen, eine Anforderung wird an ein Gerät namens "ABCD" gesendet, das ein unmittelbares untergeordnetes Element des Stamms eines ACPI-Namespace ist, dass das "ABCD"-Gerät ein untergeordnetes Gerät namens "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" angeben. CHLD._FOO" ist der vollqualifizierte Pfad und Name der Steuerungsmethode im ACPI-Namespace oder "CHLD._FOO", d. h. der Pfad und Name der Steuerungsmethode, 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 Auflisten untergeordneter Geräte und Steuerungsmethoden.
- Legen Sie StringLength auf die Anzahl der Zeichen in String fest.
- Legen Sie String auf die Eingabezeichenfolge fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista und höhere Versionen von Windows. |
| Kopfzeile | acpiioct.h (include Acpiioct.h) |