Функция EvaluateHardwareRequirement (hwreqchkapi.h)

Статья
06/02/2023

Важно!

Некоторые сведения относятся к предварительной версии продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Этот 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
Библиотека	HWREQCHK. LIB
DLL	HWREQCHK.DLL

Поделиться через