ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1_EX结构（acpiioct.h）
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_EX结构用作 IOCTL_ACPI_EVAL_METHOD_EX 请求和 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX 请求的输入。 该结构在 ACPI 命名空间中提供控件方法的路径和名称，以及 ASCII 字符串的输入参数。
语法
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;
成员
Signature
必须设置为ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX的扩展字符串输入缓冲区的签名。
MethodName[256]
一个以 NULL 结尾的 ASCII 字符串，其中包含 ACPI 命名空间中控件方法的路径和名称。 字符串可以包含的最大字符数（包括 NULL 终止符）为 256。 有关如何提供控件方法的路径和名称的详细信息，请参阅本主题后面的“备注”部分。
StringLength
字符串 提供的字符数组中的 ASCII 字符数。
String[ANYSIZE_ARRAY]
一个 ASCII 字符数组，其中包含由 StringLength指定的字符数。 字符数组不包含 NULL 终止符。
言论
设备的驱动程序可以使用IOCTL_ACPI_EVAL_METHOD_EX请求或IOCTL_ACPI_ASYNC_EVAL_METHOD_EX请求来评估设备子对象的控件方法。 如果该方法采用单个字符串输入参数，则这些请求采用输入ACPI_EVAL_INPUT_BUFFER_STRING_EX结构，如下所示：
- 将 签名 设置为ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE_EX。
-
将 MethodName 设置为 NULL 终止的字符串，该字符串向 ACPI 命名空间中的控制方法提供完整路径和名称，或与计算请求发送到的设备相对的方法的路径和名称。
例如，假设请求发送到名为“ABCD”的设备，这是 ACPI 命名空间根目录的直接子级，“ABCD”设备支持名为“CHLD”的子设备，“CHLD”设备支持名为“_FOO”的方法。 在这种情况下，评估请求可以提供“\ABCD”。CHLD._FOO，它是 ACPI 命名空间中控件方法的完全限定路径和名称，或“CHLD._FOO”，它是与 ACPI 命名空间中的“ABCD”设备相对的控件方法的路径和名称。
有关如何在 ACPI 命名空间中获取控件方法的完全限定路径和名称的详细信息，请参阅 枚举子设备和控制方法。
- 将 StringLength 设置为 String中的字符数。
- 将 字符串 设置为输入字符串。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista 和更高版本的 Windows。 |
| 标头 | acpiioct.h （include Acpiioct.h） |