Metode IDXGIOutput1::GetDisplayModeList1 (dxgi1_2.h)

Mendapatkan mode tampilan yang cocok dengan format yang diminta dan opsi input lainnya.

Sintaks

HRESULT GetDisplayModeList1(
                  DXGI_FORMAT     EnumFormat,
                  UINT            Flags,
  [in, out]       UINT            *pNumModes,
  [out, optional] DXGI_MODE_DESC1 *pDesc
);

Parameter

EnumFormat

Nilai yang DXGI_FORMAT ketik untuk format warna.

Flags

Kombinasi nilai DXGI_ENUM_MODES-ketik yang digabungkan dengan menggunakan operasi OR bitwise. Nilai yang dihasilkan menentukan opsi untuk disertakan mode tampilan. Anda harus menentukan DXGI_ENUM_MODES_SCALING untuk mengekspos mode tampilan yang memerlukan penskalakan. Mode terpusat yang tidak memerlukan penskalaan dan sesuai langsung dengan output tampilan dijumlahkan secara default.

[in, out] pNumModes

Pointer ke variabel yang menerima jumlah mode tampilan yang dikembalikan GetDisplayModeList1 di blok memori tempat pDesc menunjuk . Atur pDesc ke NULL sehingga pNumModes mengembalikan jumlah mode tampilan yang cocok dengan format dan opsi. Jika tidak, pNumModes mengembalikan jumlah mode tampilan yang dikembalikan dalam pDesc.

[out, optional] pDesc

Penunjuk ke daftar mode tampilan; atur ke NULL untuk mendapatkan jumlah mode tampilan.

Nilai kembali

Mengembalikan salah satu kode kesalahan yang dijelaskan dalam topik DXGI_ERROR . Sangat jarang, tetapi mungkin, bahwa mode tampilan yang tersedia dapat berubah segera setelah memanggil metode ini, dalam hal ini DXGI_ERROR_MORE_DATA dikembalikan (jika tidak ada cukup ruang untuk semua mode tampilan).

Keterangan

GetDisplayModeList1 diperbarui dari GetDisplayModeList untuk mengembalikan daftar struktur DXGI_MODE_DESC1 , yang merupakan deskripsi mode yang diperbarui. GetDisplayModeList bertingkah seolah-olah memanggil GetDisplayModeList1 karena GetDisplayModeList dapat mengembalikan semua mode yang ditentukan oleh DXGI_ENUM_MODES, termasuk mode stereo. Namun, GetDisplayModeList mengembalikan daftar struktur DXGI_MODE_DESC , yang merupakan deskripsi mode sebelumnya dan tidak menunjukkan mode stereo.

Metode GetDisplayModeList1 tidak menghitung mode stereo kecuali Anda menentukan bendera DXGI_ENUM_MODES_STEREO di parameter Bendera . Jika Anda menentukan DXGI_ENUM_MODES_STEREO, mode stereo disertakan dalam daftar mode yang dikembalikan yang ditunjuk parameter pDesc . Dengan kata lain, metode mengembalikan mode stereo dan mono.

Secara umum, saat Anda beralih dari mode berjendela ke layar penuh, rantai pertukaran secara otomatis memilih mode tampilan yang memenuhi (atau melebihi) resolusi, kedalaman warna, dan laju refresh rantai pertukaran. Untuk menjalankan kontrol lebih besar atas mode tampilan, gunakan GetDisplayModeList1 untuk melakukan polling set mode tampilan yang divalidasi terhadap kemampuan monitor, atau semua mode yang cocok dengan desktop (jika pengaturan desktop tidak divalidasi terhadap monitor).

Contoh kode berikut menunjukkan bahwa Anda perlu memanggil GetDisplayModeList1 dua kali. Pertama panggil GetDisplayModeList1 untuk mendapatkan jumlah mode yang tersedia, dan panggilan kedua GetDisplayModeList1 untuk mengembalikan deskripsi mode.

UINT num = 0;
DXGI_FORMAT format = DXGI_FORMAT_R32G32B32A32_FLOAT;
UINT flags         = DXGI_ENUM_MODES_INTERLACED;

pOutput->GetDisplayModeList1( format, flags, &num, 0);

...

DXGI_MODE_DESC1 * pDescs = new DXGI_MODE_DESC1[num];
pOutput->GetDisplayModeList1( format, flags, &num, pDescs);
      

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