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

要求

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

另请参阅

IOCTL_ACPI_ASYNC_EVAL_METHOD

IOCTL_ACPI_EVAL_METHOD