Bagikan melalui

Mengembalikan Kode untuk Panggilan Balik Driver Direct3D

  • Artikel

Tabel berikut ini mencantumkan nilai yang bisa dikembalikan oleh Direct3D Driver-Supplied Functions. Nilai DDHAL_DRIVER_Xxx sebenarnya dikembalikan dalam nilai pengembalian DWORD. Nilai D3D_OK, nilai D3DHAL_Xxx , dan kode kesalahan D3DERR_Xxx dikembalikan dalam anggota ddrval struktur tempat parameter fungsi tertentu menunjuk.

Untuk kode kesalahan tertentu yang dapat dikembalikan setiap fungsi, lihat deskripsi fungsi dan struktur di bagian referensi. Lihat file header Direct3D d3d.h dan d3dhal.h untuk daftar lengkap kode kesalahan dan nilai pengembalian (juga, d3d8.h dan d3d9.h untuk DirectX versi 8.0 dan 9.0). Perhatikan bahwa kode kesalahan diwakili oleh nilai negatif dan tidak dapat digabungkan.

Fungsi dalam driver Direct3D harus mengembalikan salah satu dari dua kode pengembalian: DDHAL_DRIVER_HANDLED atau DDHAL_DRIVER_NOTHANDLED. Jika driver mengembalikan DDHAL_DRIVER_HANDLED, maka driver juga harus mengembalikan D3D_OK atau salah satu nilai yang tercantum dalam d3d.h atau d3dhal.h. Fungsi dalam driver Direct3D dapat mengembalikan nilai dalam tabel berikut. Nilai-nilai ini didefinisikan dalam d3d.h dan d3dhal.h.

Nilai Makna
D3D_OK (didefinisikan sebagai DD_OK) Permintaan berhasil diselesaikan.
D3DHAL_CONTEXT_BAD Konteks yang diteruskan tidak valid.
DDHAL_DRIVER_HANDLED Driver telah melakukan operasi dan mengembalikan kode pengembalian yang valid untuk operasi tersebut di anggota ddrval struktur yang diteruskan ke panggilan balik driver. Jika kode ini D3D_OK, Direct3D melanjutkan fungsi . Jika tidak, Direct3D mengembalikan kode kesalahan yang disediakan oleh driver dan membatalkan fungsi.
DDHAL_DRIVER_NOTHANDLED Driver tidak memiliki komentar tentang operasi yang diminta. Jika driver diharuskan menerapkan panggilan balik tertentu, Direct3D melaporkan kondisi kesalahan. Jika tidak, Direct3D menangani operasi seolah-olah panggilan balik driver belum ditentukan dengan menjalankan implementasi independen perangkat Direct3D. Direct3D biasanya mengabaikan nilai apa pun yang dikembalikan di anggota ddrval dari struktur parameter panggilan balik tersebut.
D3DHAL_OUTOFCONTEXTS Tidak ada lagi konteks yang tersisa dalam proses ini.
D3DERR_UNSUPPORTEDCOLOROPERATION Operasi warna tidak didukung.