estructura ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX (acpiioct.h)
La estructura ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX se usa como entrada en una solicitud de IOCTL_ACPI_EVAL_METHOD_EX y en 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 de tipo ULONG64.
Sintaxis
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;
Miembros
Signature
Firma de un búfer de entrada entero extendido, que se debe establecer en ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_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.
IntegerArgument
Valor de argumento de tipo ULONG64 que se pasa como entrada al método de control.
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 entero, estas solicitudes toman una estructura de entrada ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX de la siguiente manera:
- Establezca Firma en ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_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.
- Establezca IntegerArgument en el valor entero de entrada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista y versiones posteriores de Windows. |
| Encabezado | acpiioct.h (include Acpiioct.h) |