ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1-Struktur (acpiioct.h)
Die ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING-Struktur wird als Eingabe für eine IOCTL_ACPI_EVAL_METHOD-Anforderung und für eine IOCTL_ACPI_ASYNC_EVAL_METHOD-Anforderung verwendet. Die -Struktur gibt den Namen einer Steuerelementmethode und ein Eingabeargument an, das eine ASCII-Zeichenfolge ist.
Syntax
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 {
ULONG Signature;
union {
UCHAR MethodName[4];
ULONG MethodNameAsUlong;
} DUMMYUNIONNAME;
ULONG StringLength;
UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING;
Member
Signature
Die Signatur eines Zeichenfolgeneingabepuffers, der auf ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE festgelegt werden muss.
DUMMYUNIONNAME
DUMMYUNIONNAME.MethodName[4]
Dieses Unionmitglied ist ein ASCII-Zeichenarray mit vier Elementen, das den Namen der Methode enthält. Beispiel: "ABCD".
DUMMYUNIONNAME.MethodNameAsUlong
Dieses Unionmitglied ist eine ULONG-typisierte Variable, die den Namen der Methode im Format (ULONG) ('DCBA') enthält, wobei der Methodenname das ASCII-Zeichenarray "ABCD" mit vier Elementen ist.
StringLength
Die Anzahl der ASCII-Zeichen im Array von Zeichen, die von String bereitgestellt wird.
String[ANYSIZE_ARRAY]
Eine ASCII-Zeichenfolge, die die Von StringLength angegebene Anzahl von Zeichen enthält. Die Zeichenfolge enthält keinen NULL-Abschlussator.
Hinweise
Wenn ein Gerät eine Steuerungsmethode namens ABCD unterstützt, die eine ASCII-Zeichenfolge als Eingabe akzeptiert, kann ein Treiber für das Gerät die Methode auswerten, indem er eine IOCTL_ACPI_EVAL_METHOD Anforderung oder eine IOCTL_ACPI_ASYNC_EVAL_METHOD Anforderung an das Gerät sendet und die Elemente der Eingabe ACPI_EVAL_INPUT_BUFFER Struktur wie folgt festlegt:
- Legen Sie Signatur auf ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE fest.
- Legen Sie MethodName auf "ABCD" oder MethodNameAsUlong auf (ULONG)('DCBA') fest.
- Legen Sie StringLength auf die Anzahl von Zeichen fest, die von String bereitgestellt wird.
- Legen Sie String auf die Eingabezeichenfolge fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 und höhere Versionen von Windows. |
| Kopfzeile | acpiioct.h (include Acpiioct.h) |