Fungsi EvaluateHardwareRequirement (hwreqchkapi.h)

Penting

Beberapa informasi berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

API ini mengevaluasi persyaratan tertentu dan mengembalikan hasil pass atau fail yang menginformasikan pemanggil apakah perangkat memenuhi persyaratan perangkat keras.

Sintaks

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

Parameter

hardwareRequirement

Menentukan persyaratan tunggal dan spesifik yang akan dievaluasi.

evaluationResult

Hasil evaluasi. Jika perangkat memenuhi persyaratan perangkat keras, nilai TRUE dikembalikan; jika tidak, nilainya adalah FALSE.

constraintsEvaluated

Nilai opsional out yang mengembalikan daftar batasan yang digunakan untuk mengevaluasi hardwareRequirement tertentu. Setiap HWREQCHK_DEVICE_HARDWARE_EVALUATION dalam array mewakili satu batasan yang dievaluasi.

Catatan

Secara internal, API mengalokasikan memori untuk argumen ini menggunakan CoTaskMemAlloc dan merupakan tanggung jawab pemanggil untuk membebaskan memori menggunakan CoTaskMemFree.

constraintEvaluationCount

Jumlah batasan yang dievaluasi yang dikembalikan dalam batasanEvaluated.

Nilai kembali

Mengembalikan HRESULT nilai yang menunjukkan keberhasilan atau kegagalan panggilan.

Persyaratan

Header	hwreqchkapi.h
Pustaka	HWREQCHK. LIB
DLL	HWREQCHK.DLL