Bagikan melalui

Metode IDirect3D9Ex::GetAdapterDisplayModeEx (d3d9.h)

  • Artikel

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

Lihat juga

IDirect3D9Ex