estructura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX (acpiioct.h)
La estructura ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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 un argumento de entrada que es una cadena ASCII.
Sintaxis
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX {
ULONG Signature;
CHAR MethodName[256];
ULONG StringLength;
UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX;
Miembros
Signature
Firma de un búfer de entrada de cadena extendida que se debe establecer en ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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 puede contener la cadena, 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.
StringLength
Número de caracteres ASCII en la matriz de caracteres proporcionados por String.
String[ANYSIZE_ARRAY]
Matriz de caracteres ASCII que contiene el número de caracteres especificados por StringLength. La matriz de caracteres no incluye un terminador NULL.
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 un único argumento de entrada de cadena, estas solicitudes toman una estructura de entrada ACPI_EVAL_INPUT_BUFFER_STRING_EX de la siguiente manera:
- Establezca Firma en ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_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 que es 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.
- Establezca StringLength en el número de caracteres de String.
- Establezca String en la cadena de entrada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista y versiones posteriores de Windows. |
| Encabezado | acpiioct.h (include Acpiioct.h) |