D3DERR

  • Artikel

Berikut ini adalah daftar nilai yang dapat dikembalikan oleh metode Direct3D. Lihat deskripsi metode individual untuk daftar nilai yang dapat dikembalikan masing-masing.

Terus-menerus Deskripsi
D3DOK_NOAUTOGEN
 Ini adalah kode sukses. Namun, pembuatan otomatis mipmap tidak didukung untuk format ini. Ini berarti bahwa pembuatan sumber daya akan berhasil tetapi tingkat mipmap tidak akan dibuat secara otomatis.
D3DERR_CONFLICTINGRENDERSTATE
 Status render yang saat ini ditetapkan tidak dapat digunakan bersama-sama.
D3DERR_CONFLICTINGTEXTUREFILTER
 Filter tekstur saat ini tidak dapat digunakan bersama-sama.
D3DERR_CONFLICTINGTEXTUREPALETTE
 Tekstur saat ini tidak dapat digunakan secara bersamaan.
D3DERR_DEVICEHUNG
 Perangkat yang mengembalikan kode ini menyebabkan adaptor perangkat keras direset oleh OS. Sebagian besar aplikasi harus menghancurkan perangkat dan berhenti. Aplikasi yang harus dilanjutkan harus menghancurkan semua objek memori video (permukaan, tekstur, blok status dll) dan memanggil Reset() untuk menempatkan perangkat dalam keadaan default. Jika aplikasi kemudian terus merender dengan cara yang sama, perangkat akan kembali ke status ini.
Hanya berlaku untuk Direct3D 9Ex.
D3DERR_DEVICELOST
 Perangkat telah hilang tetapi saat ini tidak dapat direset. Oleh karena itu, penyajian tidak dimungkinkan. Objek perangkat Direct3D selain yang mengembalikan kode ini menyebabkan adaptor perangkat keras diatur ulang oleh OS. Hapus semua objek memori video (permukaan, tekstur, blok status) dan panggil Reset() untuk mengembalikan perangkat ke status default. Jika aplikasi terus merender tanpa reset, panggilan penyajian akan berhasil.
D3DERR_DEVICENOTRESET
 Perangkat telah hilang tetapi dapat direset saat ini.
D3DERR_DEVICEREMOVED
 Adapter piranti keras telah dihapus. Aplikasi harus menghancurkan perangkat, melakukan enumerasi adaptor dan membuat perangkat Direct3D lain. Jika aplikasi terus merender tanpa memanggil Reset, panggilan penyajian akan berhasil.
Hanya berlaku untuk Direct3D 9Ex.
D3DERR_DRIVERINTERNALERROR
 Kesalahan driver internal. Aplikasi harus menghancurkan dan membuat ulang perangkat saat menerima kesalahan ini. Untuk petunjuk tentang penelusuran kesalahan ini, lihat Kesalahan Internal Driver (Direct3D 9).
D3DERR_DRIVERINVALIDCALL
 Tidak digunakan.
D3DERR_INVALIDCALL
 Panggilan metode tidak valid. Misalnya, parameter metode mungkin bukan penunjuk yang valid.
D3DERR_INVALIDDEVICE
 Tipe perangkat yang diminta tidak valid.
D3DERR_MOREDATA
 Ada lebih banyak data yang tersedia daripada yang dapat ditahan oleh ukuran buffer yang ditentukan.
D3DERR_NOTAVAILABLE
 Perangkat ini tidak mendukung teknik yang dikueri.
D3DERR_NOTFOUND
 Item yang diminta tidak ditemukan.
D3D_OK
 Tidak terjadi kesalahan.
D3DERR_OUTOFVIDEOMEMORY
 Direct3D tidak memiliki cukup memori tampilan untuk melakukan operasi. Perangkat ini menggunakan lebih banyak sumber daya dalam satu adegan daripada dapat cocok secara bersamaan ke dalam memori video. Present, PresentEx, atau CheckDeviceState dapat mengembalikan kesalahan ini. Pemulihan mirip dengan D3DERR_DEVICEHUNG, meskipun aplikasi mungkin ingin mengurangi penggunaan memori per bingkainya juga untuk menghindari kesalahan berulang.
D3DERR_TOOMANYOPERATIONS
 Aplikasi ini meminta lebih banyak operasi pemfilteran tekstur daripada yang didukung perangkat.
D3DERR_UNSUPPORTEDALPHAARG
 Perangkat tidak mendukung argumen penpaduan tekstur tertentu untuk saluran alfa.
D3DERR_UNSUPPORTEDALPHAOPERATION
 Perangkat tidak mendukung operasi penpaduan tekstur tertentu untuk saluran alfa.
D3DERR_UNSUPPORTEDCOLORARG
 Perangkat tidak mendukung argumen penpaduan tekstur tertentu untuk nilai warna.
D3DERR_UNSUPPORTEDCOLOROPERATION
 Perangkat tidak mendukung operasi penpaduan tekstur tertentu untuk nilai warna.
D3DERR_UNSUPPORTEDFACTORVALUE
 Perangkat tidak mendukung nilai faktor tekstur yang ditentukan. Tidak digunakan; disediakan hanya untuk mendukung driver yang lebih lama.
D3DERR_UNSUPPORTEDTEXTUREFILTER
 Perangkat tidak mendukung filter tekstur yang ditentukan.
D3DERR_WASSTILLDRAWING
 Operasi blit sebelumnya yang mentransfer informasi ke atau dari permukaan ini tidak lengkap.
D3DERR_WRONGTEXTUREFORMAT
 Format piksel permukaan tekstur tidak valid.
E_FAIL
 Terjadi kesalahan yang tidak ditentukan di dalam subsistem Direct3D.
E_INVALIDARG
 Parameter yang tidak valid diteruskan ke fungsi pengembalian.
E_INVALIDCALL
 Panggilan metode tidak valid. Misalnya, parameter metode mungkin memiliki nilai yang tidak valid.
E_NOINTERFACE
 Tidak ada antarmuka objek yang tersedia.
E_NOTIMPL
 Tidak diterapkan.
E_OUTOFMEMORY
 Direct3D tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan panggilan.
S_OK
 Tidak terjadi kesalahan.
S_NOT_RESIDENT
 Setidaknya satu alokasi yang terdiri dari sumber daya ada di disk. Hanya Direct3D 9Ex.
S_RESIDENT_IN_SHARED_MEMORY
 Tidak ada alokasi yang terdiri dari sumber daya yang ada di disk. Namun, setidaknya satu alokasi tidak berada dalam memori yang dapat diakses GPU. Direct3D 9Ex saja.
S_PRESENT_MODE_CHANGED
 Mode tampilan desktop telah diubah. Aplikasi dapat terus merender, tetapi mungkin ada konversi/peregangan warna. Pilih kembali format buffer yang mirip dengan mode tampilan saat ini, dan panggil Reset untuk membuat ulang rantai pertukaran. Perangkat akan meninggalkan status ini setelah Reset dipanggil. Direct3D 9Ex saja.
S_PRESENT_OCCLUDED
 Area presentasi dihilangkan. Oklusi berarti bahwa jendela presentasi diminimalkan atau perangkat lain memasuki mode layar penuh pada monitor yang sama dengan jendela presentasi dan jendela presentasi sepenuhnya berada di monitor tersebut. Oklusi tidak akan terjadi jika area klien dicakup oleh Jendela lain.
Aplikasi okludasi dapat terus merender dan semua panggilan akan berhasil, tetapi jendela presentasi okludasi tidak akan diperbarui. Sebaiknya aplikasi harus berhenti merender ke jendela presentasi menggunakan perangkat dan terus memanggil CheckDeviceState hingga S_OK atau S_PRESENT_MODE_CHANGED kembali.
Direct3D 9Ex saja.
D3DERR_UNSUPPORTEDOVERLAY
 Perangkat tidak mendukung overlay untuk ukuran atau mode tampilan yang ditentukan.
Direct3D 9Ex hanya di bawah Windows 7.
D3DERR_UNSUPPORTEDOVERLAYFORMAT
 Perangkat tidak mendukung overlay untuk format permukaan yang ditentukan.
Direct3D 9Ex hanya di bawah Windows 7.
D3DERR_CANNOTPROTECTCONTENT
 Isi yang ditentukan tidak dapat dilindungi.
Direct3D 9Ex hanya di bawah Windows 7.
D3DERR_UNSUPPORTEDCRYPTO
 Algoritma kriptografi yang ditentukan tidak didukung.
Direct3D 9Ex hanya di bawah Windows 7.
D3DERR_PRESENT_STATISTICS_DISJOINT
 Statistik saat ini tidak memiliki urutan yang teratur.
Direct3D 9Ex hanya di bawah Windows 7.

Keterangan

Kesalahan diwakili oleh nilai negatif dan tidak dapat digabungkan.

Kode pengembalian lainnya terkandung dalam S_PRESENT.

Kode fasilitas _FACD3D digunakan untuk menghasilkan kode kesalahan, seperti dalam makro berikut.

// Direct3D Errors
#define D3DERR_UNSUPPORTEDFACTORVALUE  MAKE_D3DHRESULT(2079)
#define D3DERR_WASSTILLDRAWING         MAKE_D3DHRESULT(540)
    
#define _FACD3D                  0x876   // Direct3D facility code
#define MAKE_D3DHRESULT( code )  MAKE_HRESULT( 1, _FACD3D, code )
#define MAKE_D3DSTATUS( code )   MAKE_HRESULT( 0, _FACD3D, code )

Persyaratan

Persyaratan Nilai
Header
D3d9.h

Lihat juga

Konstanta Direct3D