EvaluateHardwareRequirement, fonction (hwreqchkapi.h)

Article
06/02/2023

Important

Certaines informations se rapportent à un produit de préversion qui peut être considérablement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Cette API évalue une exigence spécifique et retourne un résultat de réussite ou d’échec indiquant à l’appelant si l’appareil répond à la configuration matérielle requise.

Syntaxe

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

Paramètres

hardwareRequirement

Spécifie une exigence unique et spécifique à évaluer par rapport à.

evaluationResult

Résultat de l’évaluation. Si l’appareil répond à la configuration matérielle requise, une valeur de TRUE est retournée ; sinon, la valeur est FALSE.

constraintsEvaluated

Valeur facultative out qui renvoie la liste des contraintes utilisées pour évaluer la configuration matérielle spécifique. Chaque HWREQCHK_DEVICE_HARDWARE_EVALUATION dans le tableau représente une contrainte unique qui a été évaluée.

Notes

En interne, l’API alloue de la mémoire pour cet argument à l’aide de CoTaskMemAlloc et il incombe à l’appelant de libérer la mémoire à l’aide de CoTaskMemFree.

constraintEvaluationCount

Nombre de contraintes évaluées qui sont retournées dans constraintsEvaluated.

Valeur retournée

Retourne une HRESULT valeur qui indique la réussite ou l’échec de l’appel.

Configuration requise


En-tête	hwreqchkapi.h
Bibliothèque	HWREQCHK. LIB
DLL	HWREQCHK.DLL

Partager via