Compartilhar via


Função EvaluateHardwareRequirement (hwreqchkapi.h)

Importante

Algumas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Essa API avalia um requisito específico e retorna um resultado de aprovação ou falha informando ao chamador se o dispositivo atende ao requisito de hardware.

Sintaxe

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

Parâmetros

hardwareRequirement

Especifica um requisito único e específico que deve ser avaliado.

evaluationResult

O resultado da avaliação. Se o dispositivo atender aos requisitos de hardware, um valor de TRUE será retornado; caso contrário, o valor será FALSE.

constraintsEvaluated

Um valor opcional out que retorna a lista de restrições que foram usadas para avaliar o hardware específicoRequirement. Cada HWREQCHK_DEVICE_HARDWARE_EVALUATION na matriz representa uma única restrição que foi avaliada.

Observação

Internamente, a API aloca memória para esse argumento usando CoTaskMemAlloc e é responsabilidade do chamador liberar a memória usando CoTaskMemFree.

constraintEvaluationCount

O número de restrições avaliadas que são retornadas em restriçõesEvaluated.

Retornar valor

Retorna um HRESULT valor que indica o êxito ou a falha da chamada.

Requisitos

   
Cabeçalho hwreqchkapi.h
Biblioteca HWREQCHK. LIB
DLL HWREQCHK.DLL