ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1结构(acpiioct.h)
ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING结构用作 IOCTL_ACPI_EVAL_METHOD 请求和 IOCTL_ACPI_ASYNC_EVAL_METHOD 请求的输入。 该结构提供控件方法的名称和作为 ASCII 字符串的输入参数。
语法
typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1 {
ULONG Signature;
union {
UCHAR MethodName[4];
ULONG MethodNameAsUlong;
} DUMMYUNIONNAME;
ULONG StringLength;
UCHAR String[ANYSIZE_ARRAY];
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_V1, ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING;
成员
Signature
字符串输入缓冲区的签名,必须设置为ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE。
DUMMYUNIONNAME
DUMMYUNIONNAME.MethodName[4]
此联合成员是包含方法名称的四元素 ASCII 字符数组。 例如,“ABCD”。
DUMMYUNIONNAME.MethodNameAsUlong
此联合成员是一个 ULONG 类型的变量,该变量包含格式 (ULONG) ('DCBA')中方法的名称,其中方法名称为四元素 ASCII 字符数组“ABCD”。
StringLength
字符串 提供的字符数组中的 ASCII 字符数。
String[ANYSIZE_ARRAY]
一个 ASCII 字符串,其中包含由 StringLength指定的字符数。 该字符串不包含 NULL 终止符。
言论
如果设备支持名为 ABCD 的控件方法(采用 ASCII 字符串作为输入),则设备的驱动程序可以通过向设备发送IOCTL_ACPI_EVAL_METHOD请求或向设备发送IOCTL_ACPI_ASYNC_EVAL_METHOD请求并设置输入ACPI_EVAL_INPUT_BUFFER结构的成员来评估该方法,如下所示:
- 将 签名 设置为ACPI_EVAL_INPUT_BUFFER_SIMPLE_STRING_SIGNATURE。
- 将 MethodName 设置为“ABCD”或 MethodNameAsUlong 为 (ULONG)(“DCBA”)。
- 将 StringLength 设置为由 String提供的字符数。
- 将 字符串 设置为输入字符串。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 及更高版本的 Windows。 |
标头 | acpiioct.h (include Acpiioct.h) |