IDXCoreAdapterList::Sort 方法

说明

根据提供的排序条件输入数组对 DXCore 适配器列表对象进行排序,其中条件数组前面的数组项的权重更高。 排序 有助于更轻松地在适配器列表中查找理想的适配器。

语法

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

parameters

numPreferences

类型: uint32_t

首选项参数指向的数组中的元素数。

首选项 [in]

类型: const DXCoreAdapterPreference*

指向 DXCoreAdapterPreference 值的常量数组的指针,表示排序条件。

返回

类型: HRESULT

如果函数成功,则返回 S_OK。 否则,它将返回 HRESULTerror代码

返回值 说明
E_INVALIDARG numPreferences 参数为零,或首选项参数为 nullptr

注解

如果操作系统 (OS) 无法识别提供的 DXCoreAdapterPreference 值,则会忽略该值,并且不会导致 API 失败。 在这种情况下,仍将考虑已知的 DXCoreAdapterPreference 值。 若要确定 API 是否理解排序类型,请调用 IDXCoreAdapterList::IsAdapterPreferenceSupported

在提供的首选项数组中之前发生的 DXCoreAdapterPreference 值会以更高的优先级进行处理。

有关每种类型应用逻辑的详细信息,请参阅 DXCoreAdapterPreference 枚举文档。 随着 OS 的发展,类型的内部逻辑可能会进行开发。

当 Sort 返回时,DXCore 适配器列表中的项将从最可取到最优先的项进行排序。 因此,使用索引 0 调用 IDXCoreAdapterList::GetAdapter 检索与请求的排序首选项类型最匹配的适配器;索引 1 是下一个最佳匹配项,等等。

另请参阅

IDXCoreAdapterListDXCore 参考使用 DXCore 枚举适配器