ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX结构(acpiioct.h)

ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX结构用作 IOCTL_ACPI_EVAL_METHOD_EX 请求和 IOCTL_ACPI_ASYNC_EVAL_METHOD_EX 请求的输入。 该结构在 ACPI 命名空间中提供控件方法的路径和名称,以及ULONG64类型的输入参数。

语法

typedef struct _ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX {
  ULONG   Signature;
  CHAR    MethodName[256];
  ULONG64 IntegerArgument;
} ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_V1_EX, ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX, *PACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX;

成员

Signature

扩展整数输入缓冲区的签名,必须设置为ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX。

MethodName[256]

一个以 NULL 结尾的 ASCII 字符串,其中包含 ACPI 命名空间中控件方法的路径和名称。 字符串可以包含的最大字符数(包括 NULL 终止符)为 256。 有关如何提供控件方法的路径和名称的详细信息,请参阅本主题后面的“备注”部分。

IntegerArgument

作为输入传递给控件方法的ULONG64类型的参数值。

言论

设备的驱动程序可以使用IOCTL_ACPI_EVAL_METHOD_EX请求或IOCTL_ACPI_ASYNC_EVAL_METHOD_EX请求来评估设备子对象的控件方法。 如果该方法采用单个整数输入参数,则这些请求采用输入ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_EX结构,如下所示:

  • 签名 设置为ACPI_EVAL_INPUT_BUFFER_SIMPLE_INTEGER_SIGNATURE_EX。
  • MethodName 设置为 NULL 终止的字符串,该字符串向 ACPI 命名空间中的控制方法提供完整路径和名称,或与计算请求发送到的设备相对的方法的路径和名称。

    例如,假设请求发送到名为“ABCD”的设备,这是 ACPI 命名空间根目录的直接子级,“ABCD”设备支持名为“CHLD”的子设备,“CHLD”设备支持名为“_FOO”的方法。 在这种情况下,评估请求可以提供“\ABCD”。CHLD._FOO,它是 ACPI 命名空间中控件方法的完全限定路径和名称,或“CHLD._FOO”,它是与 ACPI 命名空间中的“ABCD”设备相对的控件方法的路径和名称。

    有关如何在 ACPI 命名空间中获取控件方法的完全限定路径和名称的详细信息,请参阅 枚举子设备和控制方法

  • 将 integerArgument 设置为输入整数值。
有关如何使用此结构的详细信息,请参阅 评估 ACPI 控制方法

要求

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

另请参阅

IOCTL_ACPI_ASYNC_EVAL_METHOD_EX

IOCTL_ACPI_EVAL_METHOD_EX