Übersicht über die HWREQCHK-API

Artikel
06/02/2023

Hinweis

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.

Wichtig

Das in diesem Thema beschriebene Feature ist in Vorabversionen des Windows Insider Preview verfügbar. Die früheste Version, in der diese Features angezeigt werden, ist Windows Insider Preview, Version 10.0.25289.

Die HWREQCHK-Bibliothek (Hardware Requirement Evaluator) ist eine Reihe von APIs, mit denen Entwickler Informationen zu einem Hardwaregerät abrufen und ermitteln können, ob der Computer berechtigt ist, eine bestimmte Version von Windows 11 oder höher auszuführen. Bei diesen APIs handelt es sich um eine Familie von APIs, die verwendet werden, um einen Computer/ein Gerät anhand der neuen Windows 11 Hardwareanforderungen auszuwerten. Es kann auch verwendet werden, um zu bestimmen, welche der Anforderungen nicht erfüllt werden und welche Hardware des Computers derzeit vorhanden ist.

Verbrauch

Der Satz von APIs besteht aus vier zugehörigen APIs:

GetHardwareRequirementSystemInfo : Diese Funktion gibt die tatsächlichen Hardwaregerätesysteminformationen (HWREQCHK_DEVICE_HARDWARE_SYSINFO) zurück, die zum Bewerten und Vergleichen mit einer bestimmten Hardwareanforderung verwendet werden.
EvaluateHardwareRequirement : Diese Funktion wertet eine bestimmte HWREQCHK_DEVICE_HARDWARE_REQUIREMENT aus und gibt ein BOOL-Pass - oder Fail-Ergebnis zurück, das den Aufrufer darüber informiert, ob das Gerät die Hardwareanforderung erfüllt oder nicht.
GetLatestHardwareRequirement : Diese Funktion gibt die neueste definierte Anforderung für eine bestimmte HWREQCHK_PRODUCT_TYPE zurück.
GetHardwareRequirements : Diese Funktion gibt eine Sammlung definierter Hardwareanforderungen (HWREQCHK_DEVICE_HARDWARE_REQUIREMENT) für alle Produkttypen zurück.