Bagikan melalui

Metode IDirect3D9::CheckDeviceFormatConversion (d3d9helper.h)

  • Artikel

Menguji perangkat untuk melihat apakah perangkat mendukung konversi dari satu format tampilan ke format lainnya.

Sintaks

HRESULT CheckDeviceFormatConversion(
  [in] UINT       Adapter,
  [in] D3DDEVTYPE DeviceType,
  [in] D3DFORMAT  SourceFormat,
  [in] D3DFORMAT  TargetFormat
);

Parameter

[in] Adapter

Jenis: UINT

Tampilkan nomor ordinal adaptor. D3DADAPTER_DEFAULT selalu merupakan adaptor tampilan utama. Metode ini mengembalikan D3DERR_INVALIDCALL ketika nilai ini sama atau melebihi jumlah adaptor tampilan dalam sistem.

[in] DeviceType

Jenis: D3DDEVTYPE

Jenis perangkat. Anggota jenis enumerasi D3DDEVTYPE .

[in] SourceFormat

Jenis: D3DFORMAT

Format adaptor sumber. Anggota jenis D3DFORMAT yang dijumlahkan.

[in] TargetFormat

Jenis: D3DFORMAT

Format adaptor target. Anggota jenis D3DFORMAT yang dijumlahkan.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan adalah D3DERR_INVALIDCALL. Metode ini akan mengembalikan D3DERR_NOTAVAILABLE ketika perangkat keras tidak mendukung konversi antara dua format.

Keterangan

Menggunakan CheckDeviceType untuk menguji kompatibilitas antara buffer belakang yang berbeda dari format tampilan akan mengembalikan nilai yang sesuai. Ini berarti bahwa panggilan akan mencerminkan kemampuan perangkat. Jika perangkat tidak dapat merender ke format buffer kembali yang diminta, panggilan akan tetap mengembalikan D3DERR_NOTAVAILABLE. Jika perangkat dapat merender ke format, tetapi tidak dapat melakukan presentasi konversi warna, nilai yang dikembalikan juga akan D3DERR_NOTAVAILABLE. Aplikasi dapat menemukan dukungan perangkat keras untuk presentasi itu sendiri dengan memanggil CheckDeviceFormatConversion. Tidak ada emulasi perangkat lunak untuk presentasi konversi warna itu sendiri yang akan ditawarkan.

CheckDeviceFormatConversion juga dapat digunakan untuk menentukan kombinasi format permukaan sumber dan format permukaan tujuan mana yang diizinkan dalam panggilan ke StretchRect.

Konversi warna dibatasi untuk format sumber dan target berikut.

  • Format sumber harus berupa format FOURCC atau format buffer belakang yang valid. Untuk daftar ini, lihat Format FourCC dan BackBuffer atau Format Tampilan.
  • Format target harus salah satu format yang tidak ditandatangani ini:
    D3DFMT_X1R5G5B5 D3DFMT_A1R5G5B5 D3DFMT_R5G6B5
    D3DFMT_R8G8B8 D3DFMT_X8R8G8B8 D3DFMT_A8R8G8B8
    D3DFMT_A2R10G10B10 D3DFMT_A16B16G16R16 D3DFMT_A2B10G10R10
    D3DFMT_A8B8G8R8 D3DFMT_X8B8G8R8 D3DFMT_A16B16G16R16F
    D3DFMT_A32B32G32R32F
     

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d9helper.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

Isi Warna

IDirect3D9