EvaluateHardwareRequirement 函数 (hwreqchkapi.h)

重要

某些信息与预发行产品相关,在商业发布之前,该产品可能会进行实质性修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。

此 API 评估特定要求并返回通过或失败结果,通知调用方设备是否满足硬件要求。

语法

HRESULT EvaluateHardwareRequirement(
  const HWREQCHK_DEVICE_HARDWARE_REQUIREMENT *hardwareRequirement,
  BOOL                                       *evaluationResult,
  HWREQCHK_DEVICE_HARDWARE_EVALUATION        **constraintsEvaluated,
  ULONG                                      *constraintEvaluationCount
);

参数

hardwareRequirement

指定要对其进行评估的单个特定要求。

evaluationResult

计算结果。 如果设备满足硬件要求,则返回 值 TRUE ;否则,值为 FALSE

constraintsEvaluated

一个可选 out 值,返回用于评估特定 hardwareRequirement 的约束列表。 数组中的每个 HWREQCHK_DEVICE_HARDWARE_EVALUATION 都表示已计算的单个约束。

注意

在内部,API 使用 CoTaskMemAlloc 为此参数分配内存,调用方负责使用 CoTaskMemFree 释放内存。

constraintEvaluationCount

constraintsEvaluated 中返回的计算的约束数。

返回值

返回一个 HRESULT 值,该值指示调用成功或失败。

要求

   
标头 hwreqchkapi.h
Library HWREQCHK。自由
DLL HWREQCHK.DLL