Valori restituiti per DirectDraw

Le tabelle seguenti elencano i valori che possono essere restituiti dalle funzioni fornite dal driver DirectDraw. I valori DDHAL_DRIVER_Xxx vengono effettivamente restituiti nel valore restituito DWORD. I codici di errore DD_OK e DDERR_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 delle funzioni nella sezione di riferimento. Fare riferimento ai file di intestazione DirectDraw ddraw.h e dxmini.h per un elenco completo dei codici di errore e dei valori restituiti. Si noti che i codici di errore sono rappresentati da valori negativi e non possono essere combinati.

Una funzione in un driver DirectDraw deve restituire uno dei due codici restituiti: DDHAL_DRIVER_HANDLED o DDHAL_DRIVER_NOTHANDLED. Se il driver restituisce DDHAL_DRIVER_HANDLED, deve restituire anche DD_OK o uno dei codici di errore elencati in ddraw.h. Una funzione in un driver DirectDraw può restituire i codici nella tabella seguente. Questi codici sono definiti in ddraw.h.

Codice restituito	Significato
DD_OK	La richiesta è stata completata correttamente.
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 è DD_OK, DirectDraw o Direct3D procede con la funzione. In caso contrario, DirectDraw o Direct3D restituisce il codice di errore fornito dal driver e interrompe la funzione.
DDHAL_DRIVER_NOCKEYHW	Il driver di visualizzazione non è riuscito a gestire la chiamata perché ha esaurito le risorse hardware della chiave di colore.
DDHAL_DRIVER_NOTHANDLED	Il driver non ha alcun commento sull'operazione richiesta. Se è necessario che il driver abbia implementato un callback specifico, DirectDraw o Direct3D segnala una condizione di errore. In caso contrario, DirectDraw o Direct3D gestisce l'operazione come se il callback del driver non fosse stato definito eseguendo l'implementazione indipendente dal dispositivo DirectDraw o Direct3D. DirectDraw e Direct3D ignorano in genere qualsiasi valore restituito nel membro ddrval della struttura dei parametri del callback.
DDERR_GENERIC	È presente una condizione di errore non definita.
DDERR_OUTOFCAPS	L'hardware necessario per l'operazione richiesta è già stato allocato.
DDERR_UNSUPPORTED	L'operazione non è supportata.

Una funzione DxApi implementata in un driver miniport video restituisce uno dei codici nella tabella seguente. Questi codici sono definiti in dxmini.h.

Codice restituito	Significato
DX_OK	La richiesta è stata completata correttamente.
DXERR_GENERIC	È presente una condizione di errore non definita.
DXERR_OUTOFCAPS	L'hardware necessario per l'operazione richiesta è già stato allocato.
DXERR_UNSUPPORTED	L'operazione non è supportata.