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 |