estructura ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX (acpiioct.h)
La estructura de ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX se usa como entrada para una solicitud de IOCTL_ACPI_EVAL_METHOD_EX y para una solicitud de IOCTL_ACPI_ASYNC_EVAL_METHOD_EX . La estructura proporciona la ruta de acceso y el nombre de un método de control en un espacio de nombres ACPI y una matriz de argumentos de entrada de estructuras de ACPI_METHOD_ARGUMENT .
Sintaxis
typedef struct _ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG Size;
ULONG ArgumentCount;
ACPI_METHOD_ARGUMENT_V1 Argument[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_V1_EX, ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX, *PACPI_EVAL_INPUT_BUFFER_COMPLEX_EX;
Miembros
Signature
Firma de un búfer de entrada complejo extendido, que se debe establecer en ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX.
MethodName[256]
Cadena ASCII terminada en NULL que contiene la ruta de acceso y el nombre de un método de control en un espacio de nombres ACPI. El número máximo de caracteres que la cadena puede contener, incluido un terminador NULL, es 256.
Para obtener más información sobre cómo proporcionar la ruta de acceso y el nombre de un método de control, vea la sección Comentarios más adelante en este tema.
Size
Número de bytes que contiene la matriz Argument .
ArgumentCount
Número de estructuras de longitud variable ACPI_METHOD_ARGUMENT que contiene la matriz Argument . La matriz Argument puede contener un máximo de siete estructuras de argumento.
Argument[ANYSIZE_ARRAY]
Matriz de estructuras de ACPI_METHOD_ARGUMENT.
Comentarios
Un controlador de un dispositivo puede usar una solicitud de IOCTL_ACPI_EVAL_METHOD_EX o una solicitud de IOCTL_ACPI_ASYNC_EVAL_METHOD_EX para evaluar un método de control que sea un objeto secundario descendiente del dispositivo. Si el método toma una matriz compleja de argumentos, estas solicitudes toman una estructura de ACPI_EVAL_INPUT_BUFFER_COMPLEX_EX de entrada de la siguiente manera:
- Establezca Firma en ACPI_EVAL_INPUT_BUFFER_COMPLEX_SIGNATURE_EX.
-
Establezca MethodName en una cadena terminada en NULL que proporciona la ruta de acceso completa y el nombre a un método de control en el espacio de nombres ACPI o la ruta de acceso y el nombre del método relativo al dispositivo al que se envía la solicitud de evaluación.
Por ejemplo, supongamos que una solicitud se envía a un dispositivo denominado "ABCD", que es un elemento secundario inmediato de la raíz de un espacio de nombres ACPI, que el dispositivo "ABCD" admite un dispositivo secundario denominado "CHLD" y que el dispositivo "CHLD" admite un método denominado "_FOO". En este caso, la solicitud de evaluación puede proporcionar '\ABCD. CHLD._FOO, que es la ruta de acceso completa y el nombre del método de control en el espacio de nombres ACPI, o "CHLD._FOO", que es la ruta de acceso y el nombre del método de control relativo al dispositivo "ABCD" en el espacio de nombres ACPI.
Para obtener más información sobre cómo obtener la ruta de acceso completa y el nombre de un método de control en un espacio de nombres ACPI, vea Enumerar dispositivos secundarios y métodos de control.
- El tamaño se establece en el número de bytes de la matriz Argument .
- ArgumentCount se establece en el número de argumentos de la matriz Argument .
- El argumento se establece en una matriz de estructuras de ACPI_METHOD_ARGUMENT.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista y versiones posteriores de Windows. |
| Encabezado | acpiioct.h (include Acpiioct.h) |