IDXGIOutput::FindClosestMatchingMode method (dxgi.h)

  • Artikel

[Dimulai dengan Direct3D 11.1, kami sarankan untuk tidak menggunakan FindClosestMatchingMode lagi untuk menemukan mode tampilan yang paling cocok dengan mode tampilan yang diminta. Sebagai gantinya, gunakan IDXGIOutput1::FindClosestMatchingMode1, yang mendukung mode tampilan stereo.]

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

Sintaks

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

Parameter

[in] pModeToMatch

Jenis: const DXGI_MODE_DESC*

Mode tampilan yang diinginkan (lihat DXGI_MODE_DESC). Anggota DXGI_MODE_DESC dapat tidak ditentukan yang menunjukkan tidak ada preferensi untuk anggota tersebut. Nilai 0 untuk Lebar atau Tinggi menunjukkan nilai tidak ditentukan. Jika Lebar atau Tinggi adalah 0, keduanya harus 0. Pembingguna dan denominator 0 di RefreshRate menunjukkan bahwa itu tidak ditentukan. Anggota DXGI_MODE_DESC lain memiliki nilai enumerasi yang menunjukkan anggota tidak ditentukan. Jika pConcernedDeviceNULL, Format tidak dapat DXGI_FORMAT_UNKNOWN.

[out] pClosestMatch

Jenis: DXGI_MODE_DESC*

Mode yang paling cocok dengan pModeToMatch.

[in, optional] pConcernedDevice

Jenis: IUnknown*

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

Menampilkan nilai

Jenis: HRESULT

Mengembalikan salah satu DXGI_ERROR berikut.

Keterangan

FindClosestMatchingMode berperilaku mirip dengan IDXGIOutput1::FindClosestMatchingMode1 kecuali FindClosestMatchingMode hanya mempertimbangkan mode tampilan mono. IDXGIOutput1::FindClosestMatchingMode1 hanya mempertimbangkan mode stereo jika Anda mengatur anggota Stereo dalam struktur DXGI_MODE_DESC1 yang dituju pModeToMatch , dan hanya mempertimbangkan mode mono jika Stereo tidak diatur.

IDXGIOutput1::FindClosestMatchingMode1 mengembalikan set mode tampilan yang cocok hanya dengan mode stereo atau hanya mode mono. FindClosestMatchingMode bertingkah seolah-olah Anda menentukan mode input sebagai mono.

Persyaratan

   
Target Platform Windows
Header dxgi.h
Pustaka DXGI.lib

Lihat juga

IDXGIOutput