IDXCoreAdapterList::Sort, méthode

  • Article

Description

Trie un objet de liste d’adaptateurs DXCore en fonction d’un tableau d’entrée fourni de critères de tri, où les éléments du tableau plus haut dans le tableau de critères reçoivent une pondération plus élevée. Trier vous aide à trouver plus facilement votre adaptateur idéal dans une liste d’adaptateurs.

Syntaxe

HRESULT Sort(
  uint32_t numPreferences,
  _In_reads_(numPreferences) const DXCoreAdapterPreference* preferences
);

Paramètres

numPreferences

Type : uint32_t

Nombre d’éléments dans le tableau pointé vers le paramètre préférences .

préférences [in]

Type : const DXCoreAdapterPreference*

Pointeur vers un tableau constant de valeurs DXCoreAdapterPreference , représentant des critères de tri.

Retours

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreurHRESULT.

Valeur retournée Description
E_INVALIDARG L’argument numPreferences est égal à zéro ou l’argument préférences est nullptr.

Notes

Dans les cas où une valeur DXCoreAdapterPreference fournie n’est pas reconnue par le système d’exploitation, elle est ignorée et n’entraîne pas l’échec de l’API. Les valeurs DXCoreAdapterPreference connues seront toujours prises en compte dans ce cas. Pour déterminer si un type de tri est compris par l’API, appelez IDXCoreAdapterList::IsAdapterPreferenceSupported.

Les valeurs DXCoreAdapterPreference qui se produisent plus tôt dans le tableau de préférences fourni sont traitées avec une priorité plus élevée.

Pour plus d’informations sur la logique appliquée à chaque type, consultez la documentation sur l’énumération DXCoreAdapterPreference . La logique interne d’un type peut se développer au fur et à mesure que le système d’exploitation se développe.

Lorsque sort est retourné, les éléments de la liste des adaptateurs DXCore ont été triés du plus préférable au moins préférable. Ainsi, l’appel d’IDXCoreAdapterList::GetAdapter avec l’index 0 récupère l’adaptateur qui correspond le mieux aux types de préférences de tri demandés ; index 1 est la meilleure correspondance suivante, et ainsi de suite.

Voir aussi

IDXCoreAdapterList, référence DXCore, utilisation de DXCore pour énumérer les adaptateurs