Метод IDXCoreAdapterList::Sort

  • Статья

Описание

Сортирует объект списка адаптера DXCore на основе предоставленного входного массива условий сортировки, где элементы массива, более ранние в массиве условий, имеют более высокий вес. Функция сортировки упрощает поиск идеального адаптера в списке адаптеров.

Синтаксис

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

Параметры

numPreferences

Тип: uint32_t

Количество элементов, которые находятся в массиве, на который указывает параметр preferences .

настройки [в]

Тип: const DXCoreAdapterPreference*

Указатель на постоянный массив значений DXCoreAdapterPreference , представляющий критерии сортировки.

Возвращаемое значение

Тип: HRESULT

Если функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибкиHRESULT.

Возвращаемое значение Описание
E_INVALIDARG Аргумент numPreferences равен нулю, а аргумент параметров — nullptr.

Комментарии

В случаях, когда предоставленное значение DXCoreAdapterPreference не распознается операционной системой (ОС), оно игнорируется и не приводит к сбою API. В этом случае по-прежнему будут учитываться известные значения DXCoreAdapterPreference . Чтобы определить, понятен ли API тип сортировки, вызовите IDXCoreAdapterList::IsAdapterPreferenceSupported.

Значения DXCoreAdapterPreference, встречающиеся ранее в предоставленном массиве параметров, обрабатываются с более высоким приоритетом.

Дополнительные сведения о том, какая логика применяется для каждого типа, см. в документации по перечислению DXCoreAdapterPreference . Внутренняя логика для типа может развиваться по мере разработки ОС.

При возврате функции Сортировка элементы в списке адаптеров DXCore будут отсортированы от наиболее предпочтительного к наименее предпочтительному. Таким образом, при вызове IDXCoreAdapterList::GetAdapter с индексом 0 извлекается адаптер, который лучше всего соответствует запрошенным типам предпочтений сортировки; индекс 1 является следующим лучшим совпадением и т. д.

См. также раздел

IDXCoreAdapterList, справочник по DXCore, использование DXCore для перечисления адаптеров