IOCTL_ACPI_ASYNC_EVAL_METHOD IOCTL (acpiioct.h)
Ein Treiber für ein Gerät kann die IOCTL_ACPI_ASYNC_EVAL_METHOD Gerätesteuerungsanforderung verwenden, um asynchron eine ACPI-Steuerelementmethode auszuwerten, die vom Gerät unterstützt wird. Der Treiber sollte IoBuildDeviceIoControlRequest aufrufen und die folgenden Eingabe- und Ausgabeparameter übergeben, um diese Anforderung zu erstellen.
Hauptcode
Eingabepuffer
Legen Sie die IoBuildDeviceIoControlRequest Eingabeparameter wie folgt fest:
- IoControlCode- wird auf IOCTL_ACPI_ASYNC_EVAL_METHOD festgelegt.
- DeviceObject- auf einen Zeiger auf das physische Geräteobjekt (PDO) des Geräts festgelegt ist.
- InputBuffer- auf einen Zeiger auf eine Eingabepufferstruktur festgelegt ist, die vom Typ der Eingabeargumente abhängt, die an die Steuerelementmethode übergeben werden sollen. Weitere Informationen zum Typ der Eingabeargumente, die von dieser IOCTL unterstützt werden, finden Sie im Abschnitt "Hinweise" weiter unten in diesem Thema.
- InputBufferLength- wird auf die Größe des Eingabepuffers in Byte festgelegt, der von InputBufferbereitgestellt wird.
- OutputBufferLength liefert die Größe des Ausgabepuffers in Bytes, der von OutputBufferbereitgestellt wird.
- InternalDeviceIoControl auf FALSEfestgelegt ist.
- Ereignis- wird auf NULL-festgelegt.
Eingabepufferlänge
InputBufferLength- wird auf die Größe des Eingabepuffers in Byte festgelegt, der von InputBufferbereitgestellt wird.
Ausgabepuffer
Legen Sie die IoBuildDeviceIoControlRequest Ausgabeparameter wie folgt fest:
- OutputBuffer stellt einen Zeiger auf eine ACPI_EVAL_OUTPUT_BUFFER Struktur bereit, die die Ausgabeargumente aus der Steuerelementmethode enthält.
- IoStatusBlock- auf eine IO_STATUS_BLOCK-Struktur festgelegt ist.
Länge des Ausgabepuffers
OutputBufferLength liefert die Größe des Ausgabepuffers in Bytes, der von OutputBufferbereitgestellt wird.
Statusblock
Wenn die Anforderung erfolgreich ist, IoStatusBlock-–>Status ist auf STATUS_SUCCESS festgelegt; andernfalls wird der Status Member auf einen Fehlercode festgelegt. Wenn der Ausgabepuffer nicht groß genug ist, um den Ausgabepufferheader zu enthalten, wird der Status Member auf STATUS_BUFFER_TOO_SMALL festgelegt. Wenn der Ausgabepuffer groß genug ist, um den Ausgabepufferheader zu enthalten, aber nicht groß genug ist, um alle Ausgabeargumente aus der Steuerelementmethode zu enthalten, wird der Status Member auf STATUS_BUFFER_OVERFLOW festgelegt, und OutputBuffer-->Length wird auf die erforderliche Länge des Ausgabepuffers festgelegt.
Wenn die Anforderung erfolgreich ist, wird die IoStatusBlock-->Information Member auf die Anzahl der Bytes festgelegt, die im Ausgabepuffer zurückgegeben werden; andernfalls wird der Information Member auf Null festgelegt.
Bemerkungen
Ein Treiber für ein Gerät kann IOCTL_ACPI_ASYNC_EVAL_METHOD verwenden, um asynchron eine vom Gerät unterstützte Steuerelementmethode auszuwerten. Wenn das Gerät beispielsweise "ABCD" in einem ACPI-Namespace heißt und das "ABCD"-Gerät eine Methode namens "_FOO" unterstützt, kann diese IOCTL verwendet werden, um die Steuerelementmethode "_FOO" auszuwerten, indem die Anforderung an das ABCD-Gerät gesendet und der Name der Steuerelementmethode "_FOO" bereitgestellt wird.
IOCTL_ACPI_ASYNC_EVAL_METHOD unterstützt die folgenden Typen von Eingabepufferstrukturen:
ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING
ACPI_EVAL_INPUT_BUFFER_COMPLEX
Die Ausgabeargumente aus der Steuerelementmethode werden in der Struktur mit variabler Länge ACPI_EVAL_OUTPUT_BUFFER zurückgegeben, die vom OutBuffer Zeiger bereitgestellt wird. Die ACPI_EVAL_OUTPUT_BUFFER enthält ein Array mit variabler Länge ACPI_METHOD_ARGUMENT Strukturen, von denen jedes ein Ausgabeargument zurückgibt.
Informationen zum synchronen Auswerten von ACPI-Steuerelementmethoden finden Sie unter IOCTL_ACPI_EVAL_METHOD, IOCTL_ACPI_EVAL_METHOD_EXund Auswerten von ACPI-Steuerelementmethoden synchron.
IOCTL_ACPI_ASYNC_EVAL_METHOD kann nur bei IRQL-<= DISPATCH_LEVEL verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista und höhere Versionen von Windows. |
| Header- | acpiioct.h (include Acpiioct.h) |
Siehe auch
ACPI_EVAL_INPUT_BUFFER_COMPLEX
ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER