estructura ACPI_EVAL_INPUT_BUFFER_V1_EX (acpiioct.h)

La estructura ACPI_EVAL_INPUT_BUFFER_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 que no toma un argumento de entrada.

Sintaxis

typedef struct _ACPI_EVAL_INPUT_BUFFER_V1_EX {
  ULONG Signature;
  CHAR  MethodName[256];
} ACPI_EVAL_INPUT_BUFFER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_V1_EX, ACPI_EVAL_INPUT_BUFFER_EX, *PACPI_EVAL_INPUT_BUFFER_EX;

Miembros

Signature

Firma de un búfer de entrada que no incluye un argumento, que se debe establecer en ACPI_EVAL_INPUT_BUFFER_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.

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 no toma argumentos de entrada, estas solicitudes toman una estructura de entrada ACPI_EVAL_INPUT_BUFFER_EX de la siguiente manera:

• Establezca Firma en ACPI_EVAL_INPUT_BUFFER_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.

Para obtener más información sobre cómo usar esta estructura, vea Evaluación de métodos de control ACPI.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista y versiones posteriores de Windows.
Encabezado	acpiioct.h (include Acpiioct.h)

Consulte también

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX