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