IDXCoreAdapterList::Sort-Methode
BESCHREIBUNG
Sortiert ein DXCore-Adapterlistenobjekt basierend auf einem bereitgestellten Eingabearray von Sortierkriterien, wobei Arrayelementen weiter oben im Kriterienarray eine höhere Gewichtung erteilt wird. Sortieren hilft Ihnen, Ihren idealen Adapter einfacher in einer Adapterliste zu finden.
Syntax
HRESULT Sort(
uint32_t numPreferences,
_In_reads_(numPreferences) const DXCoreAdapterPreference* preferences
);
Parameter
numPreferences
Typ: uint32_t
Die Anzahl der Elemente im Array, auf die der Preferences-Parameter zeigt.
Preferences [in]
Typ: const DXCoreAdapterPreference *
Ein Zeiger auf ein konstantes Array von DXCoreAdapterPreference-Werten, die Sortierkriterien darstellen.
Rückgabe
Typ: HRESULT
Wenn die Funktion erfolgreich ist, gibt sie S_OK. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
| Rückgabewert | BESCHREIBUNG |
|---|---|
| E_INVALIDARG | Das argument numPreferences ist 0 (null), oder das Preferences-Argument ist nullptr . |
Bemerkungen
In Fällen, in denen ein bereitgestellter DXCoreAdapterPreference-Wert vom Betriebssystem nicht erkannt wird, wird er ignoriert und führt nicht dazu, dass die API fehlschlägt. Bekannte DXCoreAdapterPreference-Werte werden in diesem Fall weiterhin berücksichtigt. Um zu bestimmen, ob ein Sortiertyp von der API verstanden wird, rufen Sie IDXCoreAdapterList::IsAdapterPreferenceSupported auf.
DXCoreAdapterPreference-Werte, die zuvor im angegebenen Preferences-Array auftreten, werden mit höherer Priorität behandelt.
Weitere Informationen dazu, welche Logik für die einzelnen Typen angewendet wird, finden Sie in der DXCoreAdapterPreference-Enumerationsdokumentation. Die interne Logik für einen Typ kann sich während der Entwicklung des Betriebssystems entwickeln.
Nach der Rückgabe von Sort wurden elemente in der DXCore-Adapterliste von den am wenigsten bevorzugten elementen sortiert. Daher ruft der Aufruf von IDXCoreAdapterList::GetAdapter mit Index 0 den Adapter ab, der den angeforderten Sortierpräferenztypen am besten entspricht. Index 1 ist die nächste beste Übereinstimmung, und so weiter.
Weitere Informationen
IDXCoreAdapterList, DXCore-Referenz, Verwenden von DXCore zum Auflisten von Adaptern