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]

包含 StringLength 指定的字符数的 ASCII 字符串。 字符串不包含 NULL 终止符。

注解

如果设备支持将 ASCII 字符串作为输入的名为 ABCD 的控制方法，则设备的驱动程序可以通过向设备发送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 提供的字符数。
  • 将 “字符串 ”设置为输入字符串。
有关如何使用此结构的详细信息，请参阅 评估 ACPI 控制方法。

要求

要求 值
最低受支持的客户端 Windows 2000 及更高版本的 Windows。
标头 acpiioct.h (包括 Acpiioct.h)

另请参阅

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD