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 终止符。

注解

如果设备支持名为 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 提供的字符数。
  • 字符串 设置为输入字符串。
有关如何使用此结构的详细信息,请参阅 评估 ACPI 控件方法

要求

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

另请参阅

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD