METODE IDXGIOutput::GetDisplayModeList (dxgi.h)

[Dimulai dengan Direct3D 11.1, kami sarankan untuk tidak menggunakan GetDisplayModeList lagi untuk mengambil mode tampilan yang cocok. Sebagai gantinya, gunakan IDXGIOutput1::GetDisplayModeList1, yang mendukung mode tampilan stereo.]

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

Sintaks

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

Parameter

EnumFormat

Jenis: DXGI_FORMAT

Format warna (lihat DXGI_FORMAT).

Flags

Jenis: UINT

Opsi untuk mode yang akan disertakan (lihat DXGI_ENUM_MODES). DXGI_ENUM_MODES_SCALING perlu ditentukan untuk mengekspos mode tampilan yang memerlukan penskalaan. Mode terpusat, tidak memerlukan penskalaan dan yang sesuai langsung dengan output tampilan, dijumlahkan secara default.

[in, out] pNumModes

Jenis: UINT*

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

Jenis: DXGI_MODE_DESC*

Penunjuk ke daftar mode tampilan (lihat DXGI_MODE_DESC); atur ke NULL untuk mendapatkan jumlah mode tampilan.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan salah satu DXGI_ERROR berikut. 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).
Jika GetDisplayModeList dipanggil dari sesi Layanan Desktop Jarak Jauh (sebelumnya sesi Layanan Terminal), DXGI_ERROR_NOT_CURRENTLY_AVAILABLE dikembalikan.

Keterangan

Secara umum, saat 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 lebih banyak kontrol atas mode tampilan, gunakan API ini 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).

Seperti yang ditunjukkan, API ini dirancang untuk dipanggil dua kali. Pertama untuk mendapatkan jumlah mode yang tersedia, dan kedua untuk mengembalikan deskripsi mode.

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

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

...

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

Persyaratan

Target Platform	Windows
Header	dxgi.h
Pustaka	DXGI.lib

Lihat juga

IDXGIOutput