Codici restituiti per i callback del driver Direct3D

Nella tabella seguente sono elencati i valori che possono essere restituiti dalle funzioni Driver-Supplied Direct3D. I DDHAL_DRIVER_Xxx vengono effettivamente restituiti nel valore restituito DWORD. Il D3D_OK, i valori D3DHAL_Xxx e i codici di errore D3DERR_Xxx vengono restituiti nel membro ddrval della struttura a cui punta il parametro della funzione specifica.

Per codici di errore specifici che ogni funzione può restituire, vedere le descrizioni della funzione e della struttura nella sezione di riferimento. Fare riferimento ai file di intestazione Direct3D d3d.h e d3dhal.h per un elenco completo dei codici di errore e dei valori restituiti (anche d3d8.h e d3d9.h per DirectX versioni 8.0 e 9.0). Si noti che i codici di errore sono rappresentati da valori negativi e non possono essere combinati.

Una funzione in un driver Direct3D deve restituire uno dei due codici restituiti: DDHAL_DRIVER_HANDLED o DDHAL_DRIVER_NOTHANDLED. Se il driver restituisce DDHAL_DRIVER_HANDLED, deve restituire anche D3D_OK o uno dei valori elencati in d3d.h o d3dhal.h. Una funzione in un driver Direct3D può restituire i valori nella tabella seguente. Questi valori sono definiti in d3d.h e d3dhal.h.

Valore Significato
D3D_OK (definito come DD_OK) La richiesta è stata completata correttamente.
D3DHAL_CONTEXT_BAD Il contesto passato non è valido.
DDHAL_DRIVER_HANDLED Il driver ha eseguito l'operazione e ha restituito un codice restituito valido per tale operazione nel membro ddrval della struttura passata al callback del driver. Se questo codice è D3D_OK, Direct3D continua con la funzione . In caso contrario, Direct3D restituisce il codice di errore fornito dal driver e interrompe la funzione.
DDHAL_DRIVER_NOTHANDLED Il driver non ha alcun commento sull'operazione richiesta. Se è necessario che il driver abbia implementato un callback specifico, Direct3D segnala una condizione di errore. In caso contrario, Direct3D gestisce l'operazione come se il callback del driver non fosse stato definito eseguendo l'implementazione indipendente dal dispositivo Direct3D. Direct3D in genere ignora qualsiasi valore restituito nel membro ddrval della struttura dei parametri del callback.
D3DHAL_OUTOFCONTEXTS In questo processo non sono rimasti altri contesti.
D3DERR_UNSUPPORTEDCOLOROPERATION L'operazione di colore non è supportata.