METODE IDXGIOutput1::FindClosestMatchingMode1 (dxgi1_2.h)

Menemukan mode tampilan yang paling cocok dengan mode tampilan yang diminta.

Sintaks

HRESULT FindClosestMatchingMode1(
  [in]           const DXGI_MODE_DESC1 *pModeToMatch,
  [out]          DXGI_MODE_DESC1       *pClosestMatch,
  [in, optional] IUnknown              *pConcernedDevice
);

Parameter

[in] pModeToMatch

Penunjuk ke struktur DXGI_MODE_DESC1 yang menjelaskan mode tampilan yang cocok. Anggota DXGI_MODE_DESC1 dapat tidak ditentukan, yang menunjukkan tidak ada preferensi untuk anggota tersebut. Nilai 0 untuk Lebar atau Tinggi menunjukkan bahwa nilainya tidak ditentukan. Jika Lebar atau Tinggi adalah 0, keduanya harus 0. Pembidik dan penyebut 0 di RefreshRate menunjukkan bahwa itu tidak ditentukan. Anggota DXGI_MODE_DESC1 lain memiliki nilai enumerasi yang menunjukkan bahwa anggota tidak ditentukan. Jika pConcernedDevice adalah NULL, format anggotaDXGI_MODE_DESC1 tidak dapat DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Penunjuk ke struktur DXGI_MODE_DESC1 yang menerima deskripsi mode tampilan yang paling cocok dengan mode tampilan yang dijelaskan di pModeToMatch.

[in, optional] pConcernedDevice

Penunjuk ke antarmuka perangkat Direct3D. Jika parameter ini NULL, FindClosestMatchingMode1 hanya mengembalikan mode yang formatnya cocok dengan pModeToMatch; jika tidak, FindClosestMatchingMode1 hanya mengembalikan format yang didukung untuk pemindaian oleh perangkat. Untuk informasi tentang format yang didukung untuk pemindaian oleh perangkat di setiap tingkat fitur:

• Dukungan Format DXGI untuk Perangkat Keras Tingkat Fitur Direct3D 12.1
• Dukungan Format DXGI untuk Perangkat Keras Tingkat Fitur Direct3D 12.0
• Dukungan Format DXGI untuk Perangkat Keras Direct3D Feature Level 11.1
• Dukungan Format DXGI untuk Perangkat Keras Tingkat Fitur Direct3D 11.0
• Dukungan Perangkat Keras untuk Format Direct3D 10Level9
• Dukungan Perangkat Keras untuk Format Direct3D 10.1
• Dukungan Perangkat Keras untuk Format Direct3D 10

Nilai kembali

Mengembalikan salah satu kode kesalahan yang dijelaskan dalam topik DXGI_ERROR .

Keterangan

Perangkat Direct3D memerlukan format UNORM.

FindClosestMatchingMode1 menemukan mode tampilan terdekat yang tersedia yang cocok dengan mode yang Anda tentukan di pModeToMatch.

Jika Anda mengatur anggota Stereo dalam struktur DXGI_MODE_DESC1 di mana pModeToMatch menunjuk untuk menentukan mode stereo sebagai input, FindClosestMatchingMode1 hanya mempertimbangkan mode stereo. FindClosestMatchingMode1 hanya mempertimbangkan mode mono jika Stereo tidak diatur.

FindClosestMatchingMode1 menyelesaikan anggota mode tampilan berperingkat serupa (yaitu, semua yang ditentukan, atau semua tidak ditentukan, dan sebagainya) dalam urutan berikut:

1. ScanlineOrdering
2. Penskalaan
3. Format
4. Resolusi
5. RefreshRate

Saat FindClosestMatchingMode1 menentukan nilai terdekat untuk anggota tertentu, findClosestMatchingMode1 menggunakan anggota yang sebelumnya cocok untuk memfilter pilihan daftar mode tampilan, dan mengabaikan anggota lain. Misalnya, ketika FindClosestMatchingMode1 cocok dengan Resolusi, findClosestMatchingMode1 sudah memfilter daftar mode tampilan menurut ScanlineOrdering, Penskalaan, dan Format tertentu, saat mengabaikan RefreshRate. Pemesanan ini tidak menentukan urutan absolut untuk setiap skenario penggunaan FindClosestMatchingMode1, karena aplikasi dapat memilih beberapa nilai pada awalnya, yang secara efektif mengubah urutan penyelesaian anggota.

FindClosestMatchingMode1 cocok dengan anggota mode tampilan satu per satu, umumnya dalam urutan tertentu.

Jika anggota tidak ditentukan, FindClosestMatchingMode1 memahami nilai untuk desktop yang terkait dengan output ini. Jika output ini bukan bagian dari desktop, FindClosestMatchingMode1 menggunakan output desktop default untuk menemukan nilai. Jika aplikasi menggunakan mode tampilan yang sepenuhnya tidak ditentukan, FindClosestMatchingMode1 biasanya mengembalikan mode tampilan yang cocok dengan pengaturan desktop untuk output ini.
Karena anggota yang tidak ditentukan memiliki prioritas lebih rendah daripada anggota yang ditentukan, FindClosestMatchingMode1 menyelesaikan anggota yang tidak ditentukan lebih lambat dari anggota yang ditentukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	dxgi1_2.h
Pustaka	DXGI.lib

Lihat juga

IDXGIOutput1