Metode IDirect3D9Ex::GetAdapterDisplayModeEx (d3d9.h)
Mengambil mode tampilan saat ini dan pengaturan rotasi adaptor.
Sintaks
HRESULT GetAdapterDisplayModeEx(
[in] UINT Adapter,
[in, out] D3DDISPLAYMODEEX *pMode,
[in, out] D3DDISPLAYROTATION *pRotation
);
Parameter
[in] Adapter
Jenis: UINT
Nomor ordinal yang menunjukkan adaptor tampilan untuk kueri. D3DADAPTER_DEFAULT selalu merupakan adaptor tampilan utama.
[in, out] pMode
Jenis: D3DDISPLAYMODEEX*
Penunjuk ke struktur D3DDISPLAYMODEEX yang berisi data tentang mode tampilan adaptor. Dibandingkan dengan mode tampilan perangkat, yang mungkin tidak aktif jika perangkat tidak memiliki mode layar penuh. Dapat diatur ke NULL.
[in, out] pRotation
Jenis: D3DDISPLAYROTATION*
Arahkan ke struktur D3DDISPLAYROTATION yang menunjukkan jenis rotasi layar yang akan dilakukan aplikasi. Nilai yang dikembalikan melalui pointer ini penting ketika bendera D3DPRESENTFLAG_NOAUTOROTATE digunakan; jika tidak, ini dapat diatur ke NULL.
Menampilkan nilai
Jenis: HRESULT
Jika metode berhasil, nilai yang dikembalikan D3D_OK.
Jika Adapter berada di luar rentang atau pMode tidak valid, metode ini mengembalikan D3DERR_INVALIDCALL.
Keterangan
GetAdapterDisplayModeEx tidak mengembalikan format yang benar saat tampilan dalam format yang diperluas, seperti 2:10:10:10. Sebaliknya, ia mengembalikan format X8R8G8B8.
Untuk aplikasi berjendela, nilai S_PRESENT_MODE_CHANGED yang dikembalikan dari PresentEx atau CheckDeviceState menunjukkan bahwa mode tampilan berubah dan bahwa mode tampilan saat ini mungkin memiliki format yang berbeda. Untuk menghindari blt Present yang mengonversi warna, aplikasi berjendela dapat secara opsional mendapatkan informasi mode tampilan baru dengan menggunakan metode ini dan menyesuaikan format rantai pertukarannya. Metode ini mengembalikan D3DERR_NOTAVAILABLE jika kepala ini tidak lagi menjadi bagian dari desktop atau jika monitor terputus.
Persyaratan
Target Platform | Windows |
Header | d3d9.h |
Pustaka | D3D9.lib |