IDXCoreAdapterList：：Sort 方法

  • 项目

说明

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

语法

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

parameters

numPreferences

类型： uint32_t

preferences 参数指向的数组中的元素数。

首选项 [in]

类型： const DXCoreAdapterPreference*

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

返回

类型： HRESULT

如果函数成功，则返回 S_OK。 否则，它将返回 HRESULT错误代码。

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

备注

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

在提供的首选项数组中较早出现的 DXCoreAdapterPreference 值将采用更高的优先级进行处理。

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

当 Sort 返回时，DXCore 适配器列表中的项将从最优先到最不首选进行排序。 因此，调用索引为 0 的 IDXCoreAdapterList：：GetAdapter 会检索与请求的排序首选项类型最匹配的适配器;index 1 是下一个最佳匹配项，依此。

请参阅

IDXCoreAdapterList， DXCore 参考， 使用 DXCore 枚举适配器