D3DERR

  • Articolo

Di seguito è riportato un elenco dei valori che possono essere restituiti dai metodi Direct3D. Vedere le descrizioni dei singoli metodi per gli elenchi dei valori che ognuno può restituire.

Costante Descrizione
D3DOK_NOAUTOGEN
 Si tratta di un codice di operazione riuscita. Tuttavia, la generazione automatica di mipmaps non è supportata per questo formato. Ciò significa che la creazione di risorse avrà esito positivo, ma i livelli mipmap non verranno generati automaticamente.
D3DERR_CONFLICTINGRENDERSTATE
 Gli stati di rendering attualmente impostati non possono essere utilizzati insieme.
D3DERR_CONFLICTINGTEXTUREFILTER
 I filtri di trama correnti non possono essere usati insieme.
D3DERR_CONFLICTINGTEXTUREPALETTE
 Le trame correnti non possono essere usate contemporaneamente.
D3DERR_DEVICEHUNG
 Il dispositivo che ha restituito questo codice ha causato la reimpostazione dell'adattatore hardware dal sistema operativo. La maggior parte delle applicazioni deve distruggere il dispositivo e uscire. Le applicazioni che devono continuare devono distruggere tutti gli oggetti memoria video (superfici, trame, blocchi di stato e così via) e chiamare Reset() per impostare il dispositivo in uno stato predefinito. Se l'applicazione continua quindi il rendering nello stesso modo, il dispositivo tornerà a questo stato.
Si applica solo a Direct3D 9Ex.
D3DERR_DEVICELOST
 Il dispositivo è stato perso ma non può essere reimpostato in questo momento. Pertanto, il rendering non è possibile. Un oggetto dispositivo Direct3D diverso da quello che ha restituito questo codice ha causato la reimpostazione della scheda hardware dal sistema operativo. Eliminare tutti gli oggetti memoria video (superfici, trame, blocchi di stato) e chiamare Reset() per restituire il dispositivo a uno stato predefinito. Se il rendering dell'applicazione continua senza reimpostare, le chiamate di rendering avranno esito positivo.
D3DERR_DEVICENOTRESET
 Il dispositivo è stato perso ma può essere reimpostato in questo momento.
D3DERR_DEVICEREMOVED
 La scheda hardware è stata rimossa. L'applicazione deve eliminare definitivamente il dispositivo, enumerare le schede e creare un altro dispositivo Direct3D. Se il rendering dell'applicazione continua senza chiamare Reset, le chiamate di rendering avranno esito positivo.
Si applica solo a Direct3D 9Ex.
D3DERR_DRIVERINTERNALERROR
 Errore interno del driver. Le applicazioni devono eliminare e ricreare il dispositivo durante la ricezione di questo errore. Per suggerimenti sul debug di questo errore, vedere Errori interni del driver (Direct3D 9).For hints on debugging this error, see Driver Internal Errors (Direct3D 9).
D3DERR_DRIVERINVALIDCALL
 Non usato.
D3DERR_INVALIDCALL
 La chiamata al metodo non è valida. Ad esempio, il parametro di un metodo potrebbe non essere un puntatore valido.
D3DERR_INVALIDDEVICE
 Il tipo di dispositivo richiesto non è valido.
D3DERR_MOREDATA
 Sono disponibili più dati rispetto alle dimensioni del buffer specificate.
D3DERR_NOTAVAILABLE
 Questo dispositivo non supporta la tecnica di query.
D3DERR_NOTFOUND
 Elemento richiesto non trovato.
D3D_OK
 Non si sono verificati errori.
D3DERR_OUTOFVIDEOMEMORY
 Direct3D non dispone di memoria di visualizzazione sufficiente per eseguire l'operazione. Il dispositivo usa più risorse in una singola scena di quanto possa adattarsi contemporaneamente alla memoria video. Present, PresentEx o CheckDeviceState può restituire questo errore. Il ripristino è simile a D3DERR_DEVICEHUNG, anche se l'applicazione potrebbe voler ridurre l'utilizzo della memoria per frame, per evitare la ricorsione dell'errore.
D3DERR_TOOMANYOPERATIONS
 L'applicazione richiede più operazioni di filtro delle trame rispetto al dispositivo supportato.
D3DERR_UNSUPPORTEDALPHAARG
 Il dispositivo non supporta un argomento di fusione delle trame specificato per il canale alfa.
D3DERR_UNSUPPORTEDALPHAOPERATION
 Il dispositivo non supporta un'operazione di fusione delle trame specificata per il canale alfa.
D3DERR_UNSUPPORTEDCOLORARG
 Il dispositivo non supporta un argomento di fusione delle trame specificato per i valori di colore.
D3DERR_UNSUPPORTEDCOLOROPERATION
 Il dispositivo non supporta un'operazione di fusione delle trame specificata per i valori di colore.
D3DERR_UNSUPPORTEDFACTORVALUE
 Il dispositivo non supporta il valore del fattore di trama specificato. Non utilizzato; fornito solo per supportare i driver meno recenti.
D3DERR_UNSUPPORTEDTEXTUREFILTER
 Il dispositivo non supporta il filtro di trama specificato.
D3DERR_WASSTILLDRAWING
 L'operazione blit precedente che trasferisce informazioni da o verso questa superficie è incompleta.
D3DERR_WRONGTEXTUREFORMAT
 Il formato pixel della superficie di trama non è valido.
E_FAIL
 Si è verificato un errore non determinato all'interno del sottosistema Direct3D.
E_INVALIDARG
 Un parametro non valido è stato passato alla funzione restituita.
E_INVALIDCALL
 La chiamata al metodo non è valida. Ad esempio, il parametro di un metodo può avere un valore non valido.
E_NOINTERFACE
 Nessuna interfaccia oggetto disponibile.
E_NOTIMPL
 Non implementato.
E_OUTOFMEMORY
 Direct3D non è riuscito ad allocare memoria sufficiente per completare la chiamata.
S_OK
 Non si sono verificati errori.
S_NOT_RESIDENT
 Almeno un'allocazione che comprende le risorse è su disco. Solo Direct3D 9Ex.
S_RESIDENT_IN_SHARED_MEMORY
 Nessuna allocazione che comprende le risorse si trovano su disco. Tuttavia, almeno un'allocazione non si trova nella memoria accessibile dalla GPU. Solo Direct3D 9Ex.
S_PRESENT_MODE_CHANGED
 La modalità di visualizzazione desktop è stata modificata. L'applicazione può continuare a eseguire il rendering, ma potrebbe essere presente una conversione/estensione dei colori. Selezionare un formato di buffer nascosto simile alla modalità di visualizzazione corrente e chiamare Reimposta per ricreare le catene di scambio. Il dispositivo lascerà questo stato dopo la chiamata a Reimposta. Solo Direct3D 9Ex.
S_PRESENT_OCCLUDED
 L'area di presentazione è occlusa. L'occlusione indica che la finestra di presentazione è ridotta a icona o un altro dispositivo ha immesso la modalità schermo intero sullo stesso monitor della finestra di presentazione e la finestra di presentazione è completamente su tale monitor. L'occlusione non si verifica se l'area client è coperta da un'altra finestra.
Le applicazioni occluded possono continuare a eseguire il rendering e tutte le chiamate avranno esito positivo, ma la finestra di presentazione bloccata non verrà aggiornata. Preferibilmente l'applicazione deve interrompere il rendering nella finestra di presentazione usando il dispositivo e continuare a chiamare CheckDeviceState fino a quando non S_OK o S_PRESENT_MODE_CHANGED restituisce.
Solo Direct3D 9Ex.
D3DERR_UNSUPPORTEDOVERLAY
 Il dispositivo non supporta la sovrimpressione per la dimensione o la modalità di visualizzazione specificata.
Direct3D 9Ex solo in Windows 7.
D3DERR_UNSUPPORTEDOVERLAYFORMAT
 Il dispositivo non supporta la sovrimpressione per il formato di superficie specificato.
Direct3D 9Ex solo in Windows 7.
D3DERR_CANNOTPROTECTCONTENT
 Impossibile proteggere il contenuto specificato.
Direct3D 9Ex solo in Windows 7.
D3DERR_UNSUPPORTEDCRYPTO
 L'algoritmo di crittografia specificato non è supportato.
Direct3D 9Ex solo in Windows 7.
D3DERR_PRESENT_STATISTICS_DISJOINT
 Le statistiche presenti non hanno sequenza ordinata.
Direct3D 9Ex solo in Windows 7.

Commenti

Gli errori sono rappresentati da valori negativi e non possono essere combinati.

Altri codici restituiti sono contenuti in S_PRESENT.

Il codice della struttura _FACD3D viene usato per generare codici di errore, come nelle macro seguenti.

// Direct3D Errors
#define D3DERR_UNSUPPORTEDFACTORVALUE  MAKE_D3DHRESULT(2079)
#define D3DERR_WASSTILLDRAWING         MAKE_D3DHRESULT(540)
    
#define _FACD3D                  0x876   // Direct3D facility code
#define MAKE_D3DHRESULT( code )  MAKE_HRESULT( 1, _FACD3D, code )
#define MAKE_D3DSTATUS( code )   MAKE_HRESULT( 0, _FACD3D, code )

Requisiti

Requisito Valore
Intestazione
D3d9.h

Vedi anche

Costanti Direct3D