Mengembalikan Nilai untuk DirectDraw

Tabel berikut ini mencantumkan nilai yang dapat dikembalikan oleh fungsi yang disediakan driver DirectDraw. Nilai DDHAL_DRIVER_Xxx sebenarnya dikembalikan dalam nilai pengembalian DWORD. Nilai DD_OK dan kode kesalahan DDERR_Xxx dikembalikan dalam anggota ddRVal struktur tempat parameter fungsi tertentu menunjuk.

Untuk kode kesalahan tertentu yang dapat dikembalikan setiap fungsi, lihat deskripsi fungsi di bagian referensi. Lihat file header DirectDraw ddraw.h dan dxmini.h untuk daftar lengkap kode kesalahan dan nilai yang dikembalikan. Perhatikan bahwa kode kesalahan diwakili oleh nilai negatif dan tidak dapat digabungkan.

Fungsi dalam driver DirectDraw 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 DD_OK atau salah satu kode kesalahan yang tercantum dalam ddraw.h. Fungsi dalam driver DirectDraw dapat mengembalikan kode dalam tabel berikut. Kode-kode ini didefinisikan dalam ddraw.h.

Menampilkan kode	Makna
DD_OK	Permintaan berhasil diselesaikan.
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 DD_OK, DirectDraw atau Direct3D melanjutkan fungsi . Jika tidak, DirectDraw atau Direct3D mengembalikan kode kesalahan yang disediakan oleh driver dan membatalkan fungsi.
DDHAL_DRIVER_NOCKEYHW	Pengandar tampilan tidak dapat menangani panggilan karena kehabisan sumber daya perangkat keras kunci warna.
DDHAL_DRIVER_NOTHANDLED	Driver tidak memiliki komentar tentang operasi yang diminta. Jika driver diharuskan menerapkan panggilan balik tertentu, DirectDraw atau Direct3D melaporkan kondisi kesalahan. Jika tidak, DirectDraw atau Direct3D menangani operasi seolah-olah panggilan balik driver belum ditentukan dengan menjalankan implementasi independen perangkat DirectDraw atau Direct3D. DirectDraw dan Direct3D biasanya mengabaikan nilai apa pun yang dikembalikan dalam anggota ddrval dari struktur parameter panggilan balik tersebut.
DDERR_GENERIC	Ada kondisi kesalahan yang tidak ditentukan.
DDERR_OUTOFCAPS	Perangkat keras yang diperlukan untuk operasi yang diminta telah dialokasikan.
DDERR_UNSUPPORTED	Operasi tidak didukung.

Fungsi DxApi yang diimplementasikan dalam driver miniport video mengembalikan salah satu kode dalam tabel berikut. Kode-kode ini didefinisikan dalam dxmini.h.

Menampilkan kode	Makna
DX_OK	Permintaan berhasil diselesaikan.
DXERR_GENERIC	Ada kondisi kesalahan yang tidak ditentukan.
DXERR_OUTOFCAPS	Perangkat keras yang diperlukan untuk operasi yang diminta telah dialokasikan.
DXERR_UNSUPPORTED	Operasi tidak didukung.