ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX Struktur (acpiioct.h)
Die ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_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 namen einer Steuerelementmethode in einem ACPI-Namespace und ein Eingabeargument vom Typ ULONG64.
Syntax
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG64 IntegerArgument;
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX;
Angehörige
Signature
Die Signatur eines erweiterten ganzzahligen Eingabepuffers, der auf ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_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-Terminators, beträgt 256. Weitere Informationen zum Angeben des Pfads und des Namens einer Steuerelementmethode finden Sie im Abschnitt "Hinweise" weiter unten in diesem Thema.
IntegerArgument
Ein Argumentwert vom Typ ULONG64, der als Eingabe an die Steuerelementmethode übergeben wird.
Bemerkungen
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 Steuerelementmethode auszuwerten, die ein untergeordnetes untergeordnetes Objekt des Geräts ist. Wenn die Methode ein einzelnes ganzzahliges Eingabeargument verwendet, nehmen diese Anforderungen eine Eingabe ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX Struktur wie folgt ein:
- Legen Sie Signatur- auf ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX fest.
-
Legen Sie MethodName- auf eine MIT NULL beendete 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 zum Gerät ist, an das die Auswertungsanforderung gesendet wird.
Angenommen, eine Anforderung wird an ein Gerät mit dem Namen "ABCD" gesendet, das ein unmittelbares untergeordnetes Element des Stamms eines ACPI-Namespaces 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 Steuerelementmethode im ACPI-Namespace oder "CHLD._FOO", der Pfad und Name der Steuerelementmethode, die relativ zum "ABCD"-Gerät im ACPI-Namespace ist.
Weitere Informationen zum Abrufen des vollqualifizierten Pfads und des Namens einer Steuerelementmethode in einem ACPI-Namespace finden Sie unter Aufzählen untergeordneter Geräte und Steuerelementmethoden.
- Legen Sie IntegerArgument- auf den Ganzzahlwert der Eingabe fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista und höhere Versionen von Windows. |
| Header- | acpiioct.h (include Acpiioct.h) |