IOCTL_ACPI_ASYNC_EVAL_METHOD_EX IOCTL (acpiioct.h)

Artikel
02/22/2024

Ein Treiber für ein Gerät kann die IOCTL_ACPI_ASYNC_EVAL_METHOD_EX Gerätesteuerungsanforderung verwenden, um eine ACPI-Steuerungsmethode asynchron auszuwerten, die von einem untergeordneten Gerät des Geräts unterstützt wird. Der Treiber sollte IoBuildDeviceIoControlRequest aufrufen und die folgenden Eingabe- und Ausgabeparameter übergeben, um diese Anforderung zu erstellen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Legen Sie die IoBuildDeviceIoControlRequest-Eingabeparameter wie folgt fest:

IoControlCode ist auf IOCTL_ACPI_ASYNC_EVAL_METHOD_EX festgelegt.
DeviceObject ist auf einen Zeiger auf das objekt des physischen Geräts (PDO) des Geräts festgelegt.
InputBuffer ist auf einen Zeiger auf eine Eingabepufferstruktur festgelegt, die vom Typ der Eingabeargumente abhängt, die an die Steuerelementmethode übergeben werden sollen. Weitere Informationen zu den Typeingabeargumenten, die von dieser IOCTL unterstützt werden, finden Sie weiter unten in diesem Thema im Abschnitt Hinweise.
InputBufferLength wird auf die Größe des Eingabepuffers in Bytes festgelegt, der von InputBuffer bereitgestellt wird.
OutputBufferLength stellt die Größe des von OutputBuffer bereitgestellten Ausgabepuffers in Bytes bereit.
InternalDeviceIoControl ist auf FALSE festgelegt.
Das Ereignis ist auf NULL festgelegt.

Länge des Eingabepuffers

InputBufferLength wird auf die Größe des Eingabepuffers in Bytes festgelegt, der von InputBuffer bereitgestellt 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 der Steuerelementmethode enthält.
IoStatusBlock ist auf eine IO_STATUS_BLOCK-Struktur festgelegt.

Länge des Ausgabepuffers

OutputBufferLength stellt die Größe des von OutputBuffer bereitgestellten Ausgabepuffers in Bytes bereit.

Statusblock

Wenn die Anforderung erfolgreich ist, wird IoStatusBlock-Status> 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 der Steuerelementmethode zu enthalten, wird der Status-Member auf STATUS_BUFFER_OVERFLOW und OutputBuffer-Length> auf die erforderliche Länge des Ausgabepuffers festgelegt.

Wenn die Anforderung erfolgreich ist, wird der IoStatusBlock-Information-Member> auf die Anzahl der Bytes festgelegt, die im Ausgabepuffer zurückgegeben werden. Andernfalls wird der Information-Member auf 0 (null) festgelegt.

Hinweise

Ein Treiber für ein Gerät kann IOCTL_ACPI_ASYNC_EVAL_METHOD_EX verwenden, um eine Steuerungsmethode asynchron auszuwerten, die von einem untergeordneten Objekt im Namespace des Geräts unterstützt wird. Der Pfad und Name der Steuerungsmethode, die von dieser Anforderung bereitgestellt wird, muss entweder der vollqualifizierte Pfad und Name der Methode im ACPI-Namespace oder der Pfad und der Name der Methode relativ zum Gerät sein, an das die Anforderung gesendet wird. Angenommen, ein Gerät mit dem Namen "ABCD" ist ein unmittelbares untergeordnetes Element des Stamms eines ACPI-Namespace, 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 sendet ein Treiber zur Auswertung der "_FOO"-Methode eine Auswertungsanforderung an das "ABCD"-Gerät und gibt entweder den Pfad und den Namen "\ABCD" an. CHLD._FOO", wobei es sich um den vollqualifizierten Pfad und Namen im ACPI-Namespace handelt, oder um den Pfad und Namen "CHLD._FOO", bei dem es sich um den Pfad und den Namen relativ zum "ABCD"-Gerät im ACPI-Namespace handelt.

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX unterstützt die folgenden Typen von Eingabepufferstrukturen:

ACPI_EVAL_INPUT_BUFFER_EX

ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX

ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX

ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX

Die Ausgabeargumente der Steuerelementmethode werden in der strukturvariablen ACPI_EVAL_OUTPUT_BUFFER zurückgegeben, die vom OutBuffer-Zeiger bereitgestellt wird. Die ACPI_EVAL_OUTPUT_BUFFER enthält ein Array von strukturen mit variabler Länge ACPI_METHOD_ARGUMENT, von denen jede ein Ausgabeargument zurückgibt.

Informationen zum synchronen Auswerten einer ACPI-Steuerungsmethode finden Sie unter IOCTL_ACPI_EVAL_METHOD, IOCTL_ACPI_EVAL_METHOD_EX und Synchrones Auswerten von ACPI-Steuerungsmethoden.

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX kann nur bei IRQL <= DISPATCH_LEVEL verwendet werden.