pepfx.h) (PEP_ACPI_EVALUATE_CONTROL_METHOD 结构

  • 项目

PEP_ACPI_EVALUATE_CONTROL_METHOD 结构指定要计算的 ACPI 控制方法、要提供给此方法的输入参数以及计算结果的输出缓冲区。

语法

typedef struct _PEP_ACPI_EVALUATE_CONTROL_METHOD {
  PEPHANDLE             DeviceHandle;
  ULONG                 RequestFlags;
  union {
    ULONG       MethodName;
    ANSI_STRING MethodNameString;
  };
  NTSTATUS              MethodStatus;
  PVOID                 CompletionContext;
  ULONG                 InputArgumentCount;
  SIZE_T                InputArgumentSize;
  PACPI_METHOD_ARGUMENT InputArguments;
  ULONG                 OutputArgumentCount;
  SIZE_T                OutputArgumentSize;
  PACPI_METHOD_ARGUMENT OutputArguments;
} PEP_ACPI_EVALUATE_CONTROL_METHOD, *PPEP_ACPI_EVALUATE_CONTROL_METHOD;

成员

DeviceHandle

一个 PEPHANDLE 值，该值标识设备对 ACPI 服务的注册。 平台扩展插件 (PEP) 提供此句柄以响应以前的 PEP_NOTIFY_ACPI_REGISTER_DEVICE 通知。

RequestFlags

一组标志。 此成员包含以下值之一。

标志名称 值 含义
PEP_ACPI_ECM_FLAG_NONE 0x0 不是有效的控制方法名称。
PEP_ACPI_ECM_FLAG_RELATIVE_NAME 0x1 MethodNameUlong 成员包含相对路径的控制方法名称。
PEP_ACPI_ECM_FLAG_FULLY_QUALIFIED_NAME 0x2 MethodNameString 成员包含完全限定的控制方法名称。

MethodName

一个 ULONG 值，该值包含 ACPI 控制方法的四个字符相对路径名称。

MethodNameString

包含 ACPI 控制方法的完全限定名称的 ANSI_STRING 结构。 此名称指定 ACPI 命名空间中方法的路径和名称。 有关详细信息，请参阅 枚举子设备和控制方法。

MethodStatus

一个 NTSTATUS 值，该值指示 ACPI 控制方法的评估状态。 将此成员设置为 STATUS_SUCCESS 以指示平台扩展插件 (PEP) 成功完成对 方法的评估。 设置为 STATUS_NOT_SUPPORTED 表示 PEP 无法识别控制方法。 设置为 STATUS_BUFFER_TOO_SMALL 指示 InputArgumentSize 成员指定的输出缓冲区大小不足以包含方法结果。

如果 PEP 要异步计算方法，请将此成员设置为 STATUS_PENDING并从 AcceptAcpiNotification 回调返回。 稍后，评估完成后，PEP 会调用 CompleteWork 例程来通知 Windows 电源管理框架 (PoFx) 控制方法的评估已完成。

CompletionContext

指向完成上下文值的指针。 仅当以异步方式计算控制方法时，PEP 才使用此成员。 在这种情况下，PEP 在调用 CompleteWork 例程时提供此完成上下文指针，该例程通知 Windows 电源管理框架 (PoFx) 控制方法的评估已完成。 此调用的输入参数中包括一个指向 PEP 已向其写入完成上下文指针 的PEP_WORK_ACPI_EVALUATE_CONTROL_METHOD_COMPLETE 结构的指针。 上下文对 PEP 不透明，并且包含 PoFx 内部使用的数据。

InputArgumentCount

InputArguments 成员指向的输入缓冲区中的输入参数数。 每个参数都以指定参数大小的 ACPI_METHOD_ARGUMENT 结构开头。 目前，最大 InputArgumentCount 值为 1。

InputArgumentSize

InputArguments 成员指向的输入缓冲区的大小（以字节为单位）。

InputArguments

指向输入缓冲区的指针，该缓冲区包含指定指定 ACPI 控制方法的输入参数 的ACPI_METHOD_ARGUMENT 结构。

OutputArgumentCount

OutputArguments 成员指向的输出缓冲区中的输出参数数。 每个参数都以指定参数大小的 ACPI_METHOD_ARGUMENT 结构开头。 目前，允许的最大 OutputArgumentCount 值为 1。

OutputArgumentSize

输入时， OutputArguments 成员指向的输出缓冲区的大小（以字节为单位）。 如果此缓冲区的大小不足以包含计算方法的结果，则 PEP 会用所需的大小覆盖 OutputArgumentSize 输入值，并将 MethodStatus 成员设置为STATUS_BUFFER_TOO_SMALL。

OutputArguments

指向输出缓冲区的指针，PEP 向其写入包含计算指定 ACPI 控制方法的结果 的ACPI_METHOD_ARGUMENT 结构。

注解

此结构由 PEP_NOTIFY_ACPI_EVALUATE_CONTROL_METHOD 通知使用。 MethodStatus 成员包含 PEP 写入结构以响应此通知的输出值。 OutputArgumentSize 成员包含发送通知时由 PoFx 提供的输入值。 如果输入值小于所需的输出缓冲区大小，PEP 可能会用输出值覆盖此输入值。 此结构的所有其他成员都包含发送通知时由 PoFx 提供的输入值。

如果 RequestFlags = PEP_ACPI_ECM_FLAG_RELATIVE_NAME) ，则此结构中的未命名联合包含四个字符的路径相对控制方法名称 (，如果 RequestFlags = PEP_ACPI_ECM_FLAG_FULLY_QUALIFIED_NAME) ，则包含完全限定的控制方法名称 (。

要求

要求 值
最低受支持的客户端 从 Windows 10 开始支持。
标头 pepfx.h (包括 Pep_x.h)

另请参阅