Metode IDirect3D9::EnumAdapterModes (d3d9.h)

Artikel
08/23/2023

Mengkueri perangkat untuk menentukan apakah adaptor yang ditentukan mendukung format dan mode tampilan yang diminta. Metode ini dapat digunakan dalam perulangan untuk menghitung semua mode adaptor yang tersedia.

Sintaks

HRESULT EnumAdapterModes(
  [in]  UINT           Adapter,
  [in]  D3DFORMAT      Format,
  [in]  UINT           Mode,
  [out] D3DDISPLAYMODE *pMode
);

Parameter

[in] Adapter

Jenis: UINT

Nomor ordinal yang menunjukkan adaptor tampilan untuk dijumlahkan. D3DADAPTER_DEFAULT selalu merupakan adaptor tampilan utama. Metode ini mengembalikan D3DERR_INVALIDCALL ketika nilai ini sama atau melebihi jumlah adaptor tampilan dalam sistem.

[in] Format

Jenis: D3DFORMAT

Format piksel yang diperbolehkan. Lihat Keterangan.

[in] Mode

Jenis: UINT

Mewakili indeks mode tampilan yang merupakan bilangan bulat yang tidak ditandatangani antara nol dan nilai yang dikembalikan oleh GetAdapterModeCount dikurangi satu.

[out] pMode

Jenis: D3DDISPLAYMODE*

Penunjuk ke mode tampilan jenis D3DDISPLAYMODE yang tersedia. Lihat Keterangan.

Nilai kembali

Jenis: HRESULT

Jika perangkat dapat digunakan pada adaptor ini, D3D_OK dikembalikan.
Jika Adaptor sama atau melebihi jumlah adaptor tampilan dalam sistem, D3DERR_INVALIDCALL dikembalikan.
Jika salah satu format permukaan tidak didukung atau jika akselerasi perangkat keras tidak tersedia untuk format yang ditentukan, D3DERR_NOTAVAILABLE dikembalikan.

Keterangan

Aplikasi menyediakan mode tampilan dan format ke EnumAdapterModes yang mengembalikan mode tampilan. Metode ini dapat digunakan dalam perulangan untuk menghitung semua mode tampilan yang tersedia.

Aplikasi menentukan format dan enumerasi dibatasi untuk mode tampilan yang sama persis dengan format (alfa diabaikan). Format yang diizinkan (yang merupakan anggota D3DFORMAT) adalah sebagai berikut:

D3DFMT_A1R5G5B5
D3DFMT_A2R10G10B10
D3DFMT_A8R8G8B8
D3DFMT_R5G6B5
D3DFMT_X1R5G5B5
D3DFMT_X8R8G8B8

Selain itu, EnumAdapterModes memperlakukan format piksel 565 dan 555 sebagai setara, dan mengembalikan versi yang benar. Perbedaannya hanya berlaku ketika aplikasi mengunci buffer belakang dan ada bendera eksplisit yang harus diatur aplikasi untuk mencapai hal ini.

Persyaratan


Target Platform	Windows
Header	d3d9.h (termasuk D3D9.h)
Pustaka	D3D9.lib

Lihat juga

IDirect3D9

Bagikan melalui