EvaluateHardwareRequirement-Funktion (hwreqchkapi.h)

Artikel
06/02/2023

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Diese API wertet eine bestimmte Anforderung aus und gibt ein Pass- oder Fail-Ergebnis zurück, das den Aufrufer darüber informiert, ob das Gerät die Hardwareanforderung erfüllt.

Syntax

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

Parameter

hardwareRequirement

Gibt eine einzelne und spezifische Anforderung an, anhand derer ausgewertet werden soll.

evaluationResult

Das Auswertungsergebnis. Wenn das Gerät die Hardwareanforderungen erfüllt, wird der Wert von TRUE zurückgegeben, andernfalls ist FALSEder Wert .

constraintsEvaluated

Ein optionaler out Wert, der die Liste der Einschränkungen zurückgibt, die zum Auswerten des spezifischen hardwareRequirements verwendet wurden. Jede HWREQCHK_DEVICE_HARDWARE_EVALUATION im Array stellt eine einzelne Einschränkung dar, die ausgewertet wurde.

Hinweis

Intern weist die API Arbeitsspeicher für dieses Argument mithilfe von CoTaskMemAlloc zu, und es liegt in der Verantwortung des Aufrufers, den Arbeitsspeicher mithilfe von CoTaskMemFree freizugeben.

constraintEvaluationCount

Die Anzahl der ausgewerteten Einschränkungen, die in constraintsEvaluated zurückgegeben werden.

Rückgabewert

Gibt einen HRESULT Wert zurück, der den Erfolg oder Fehler des Aufrufs angibt.

Anforderungen


Kopfzeile	hwreqchkapi.h
Bibliothek	HWREQCHK. LIB
DLL	HWREQCHK.DLL

Share via