共用方式為

IDXCoreAdapterList：：Sort 方法

  • 發行項

描述

根據提供的排序準則輸入陣列來排序 DXCore 配接器清單物件，其中準則陣列稍早的陣列專案會獲得較高的權數。 排序 可協助您更輕鬆地在配接器清單中尋找理想的配接器。

語法

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

參數

numPreferences

類型： uint32_t

喜好設定參數所指向之陣列中的專案數目。

喜好設定 [in]

類型：const DXCoreAdapterPreference*

DXCoreAdapterPreference值的常數陣列指標，代表排序準則。

傳回

類型： HRESULT

如果函式成功，它會 傳回S_OK。 否則，它會傳回 HRESULT錯誤碼。

傳回值 描述
E_INVALIDARG numPreferences引數為零，或喜好設定引數為 nullptr 。

備註

如果作業系統 (OS) 無法辨識提供的 DXCoreAdapterPreference 值，則會忽略它，而且不會造成 API 失敗。 在此情況下，仍會考慮已知的 DXCoreAdapterPreference 值。 若要判斷 API 是否瞭解排序類型，請呼叫 IDXCoreAdapterList：：IsAdapterPreferenceSupported。

稍早在提供的喜好設定陣列中發生的DXCoreAdapterPreference值會以較高的優先順序來處理。

如需每個類型套用哪些邏輯的詳細資料，請參閱 DXCoreAdapterPreference 列舉檔。 型別的內部邏輯可能會隨著作業系統開發而開發。

當 Sort 傳回時，DXCore 配接器清單中的專案會從最偏好排序為最不理想。 因此，使用索引 0 呼叫 IDXCoreAdapterList：：GetAdapter 會擷取最符合要求的排序喜好設定類型的配接器;index 1 是下一個最佳相符專案，依此類加。

另請參閱

IDXCoreAdapterList、 DXCore 參考、 使用 DXCore 列舉配接器