Codici restituiti per i callback del driver Direct3D

  • Articolo

Nella tabella seguente sono elencati i valori che possono essere restituiti dalle funzioni Driver-Supplied Direct3D. I valori DDHAL_DRIVER_Xxx vengono effettivamente restituiti nel valore restituito DWORD. Il valore 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 la descrizione 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 restituito un codice restituito valido per tale operazione nel membro ddrval della struttura passata al callback del driver. Se questo codice è D3D_OK, Direct3D procede 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 il driver deve aver 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 ignora in genere qualsiasi valore restituito nel membro ddrval della struttura dei parametri del callback.
D3DHAL_OUTOFCONTEXTS Non ci sono più contesti rimasti in questo processo.
D3DERR_UNSUPPORTEDCOLOROPERATION L'operazione di colore non è supportata.