IDXGIOutput6::GetDesc1 method (dxgi1_6.h)

Dapatkan deskripsi yang diperluas tentang output yang mencakup karakteristik warna dan jenis koneksi.

Sintaks

HRESULT GetDesc1(
  [out] DXGI_OUTPUT_DESC1 *pDesc
);

Parameter

[out] pDesc

Jenis: DXGI_OUTPUT_DESC1*

Penunjuk ke deskripsi output (lihat DXGI_OUTPUT_DESC1).

Menampilkan nilai

Jenis: HRESULT

Mengembalikan kode yang menunjukkan keberhasilan atau kegagalan. S_OK jika berhasil, DXGI_ERROR_INVALID_CALL jika pDesc diteruskan sebagai NULL.

Keterangan

Beberapa skenario tidak memiliki nilai yang terdefinisi dengan baik untuk semua bidang dalam struktur ini. Misalnya, jika IDXGIOutput ini mewakili set klon/duplikat, atau jika EDID kehilangan atau data yang tidak valid. Dalam kasus ini, OS akan memberikan beberapa nilai default yang sesuai dengan tampilan SDR standar.

Karakteristik warna dan luminansi output yang dilaporkan dapat menyesuaikan secara dinamis saat sistem berjalan karena tindakan pengguna atau perubahan kondisi sekitar. Oleh karena itu, aplikasi harus secara berkala mengkueri IDXGIFactory::IsCurrent dan membuat ulang IDXGIFactory mereka jika menampilkan FALSE. Kemudian kueri ulang GetDesc1 dari output setara pabrik baru untuk mengambil informasi warna terbaru.

Untuk detail selengkapnya tentang cara menulis aplikasi yang bereaksi dinamis terhadap kemampuan pemantauan, lihat Menggunakan DirectX dengan tampilan rentang dinamis tinggi dan Warna Tingkat Lanjut.

Pada desktop DPI tinggi, GetDesc1 mengembalikan ukuran layar yang divisualisasikan kecuali aplikasi ditandai sadar DPI tinggi. Untuk informasi tentang menulis aplikasi Win32 yang sadar DPI, lihat DPI Tinggi.

Persyaratan

Target Platform	Windows
Header	dxgi1_6.h
Pustaka	DXGI.lib

Lihat juga

Antarmuka DXGI

IDXGIOutput6