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 stellt den Namen einer Steuerelementmethode und ein Eingabeargument bereit, 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;
Angehörige
Signature
Die Signatur eines Zeichenfolgeneingabepuffers, der auf ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE festgelegt werden muss.
DUMMYUNIONNAME
DUMMYUNIONNAME.MethodName[4]
Dieses Union-Element ist ein ASCII-Zeichenarray mit vier Elementen, das den Namen der Methode enthält. Beispiel: "ABCD".
DUMMYUNIONNAME.MethodNameAsUlong
Dieser Union-Member ist eine ULONG-Typvariable, die den Namen der Methode im Format (ULONG) ('DCBA') enthält, wobei der Methodenname das ASCII-Zeichenarray mit vier Elementen "ABCD" ist.
StringLength
Die Anzahl der ASCII-Zeichen im Array von Zeichen, die von Stringbereitgestellt werden.
String[ANYSIZE_ARRAY]
Eine ASCII-Zeichenzeichenfolge, die die Anzahl der Zeichen enthält, die durch StringLength-angegeben wird. Die Zeichenfolge enthält keinen NULL-Terminator.
Bemerkungen
Wenn ein Gerät eine Steuerelementmethode namens ABCD unterstützt, die eine ASCII-Zeichenfolge als Eingabe akzeptiert, kann ein Treiber für das Gerät die Methode auswerten, indem eine IOCTL_ACPI_EVAL_METHOD Anforderung oder eine IOCTL_ACPI_ASYNC_EVAL_METHOD Anforderung an das Gerät gesendet und die Member der Eingabe ACPI_EVAL_INPUT_BUFFER Struktur wie folgt festgelegt werden:
- 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 der Zeichen fest, die von String-angegeben werden.
- Legen Sie Zeichenfolge auf die Eingabezeichenfolge fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 und höhere Versionen von Windows. |
| Header- | acpiioct.h (include Acpiioct.h) |