D3DERR

Im Folgenden finden Sie eine Liste der Werte, die von Direct3D-Methoden zurückgegeben werden können. Listen der Werte, die jeweils zurückgeben können, finden Sie in den Beschreibungen der einzelnen Methoden.

Konstante Beschreibung
D3DOK _ NOAUTOGEN
Dies ist ein Erfolgscode. Die automatische Generierung von Mipmaps wird für dieses Format jedoch nicht unterstützt. Dies bedeutet, dass die Ressourcenerstellung erfolgreich ist, die Mipmapebenen jedoch nicht automatisch generiert werden.
D3DERR _ CONFLICTINGRENDERSTATE
Die derzeit festgelegten Renderzustände können nicht zusammen verwendet werden.
D3DERR _ CONFLICTINGTEXTUREFILTER
Die aktuellen Texturfilter können nicht zusammen verwendet werden.
D3DERR _ CONFLICTINGTEXTUREPALETTE
Die aktuellen Texturen können nicht gleichzeitig verwendet werden.
D3DERR _ DEVICEHUNG
Das Gerät, das diesen Code zurückgegeben hat, führte dazu, dass der Hardwareadapter vom Betriebssystem zurückgesetzt wurde. Die meisten Anwendungen sollten das Gerät zerstören und beenden. Anwendungen, die fortfahren müssen, sollten alle Videospeicherobjekte (Oberflächen, Texturen, Zustandsblöcke usw.) zerstören und Reset() aufrufen, um das Gerät in einen Standardzustand zu bringen. Wenn die Anwendung das Rendering dann auf die gleiche Weise fortsetzt, wird das Gerät in diesen Zustand zurückkehren.
Gilt nur für Direct3D 9Ex.
D3DERR _ DEVICELOST
Das Gerät ist verloren gegangen, kann aber derzeit nicht zurückgesetzt werden. Daher ist das Rendern nicht möglich. Ein anderes Direct3D-Geräteobjekt als das, das diesen Code zurückgegeben hat, führte dazu, dass der Hardwareadapter vom Betriebssystem zurückgesetzt wurde. Löschen Sie alle Videospeicherobjekte (Oberflächen, Texturen, Zustandsblöcke), und rufen Sie Reset() auf, um das Gerät in den Standardzustand zurückzusetzen. Wenn die Anwendung das Rendering ohne Zurücksetzung fortsetzt, sind die Renderingaufrufe erfolgreich.
D3DERR _ DEVICENOTRESET
Das Gerät ist verloren gegangen, kann aber zu diesem Zeitpunkt zurückgesetzt werden.
D3DERR _ DEVICEREMOVED
Der Hardwareadapter wurde entfernt. Die Anwendung muss das Gerät zerstören, Adapter aufzählen und ein weiteres Direct3D-Gerät erstellen. Wenn die Anwendung das Rendering ohne Aufruf von Reset fortsetzt, sind die Renderingaufrufe erfolgreich.
Gilt nur für Direct3D 9Ex.
D3DERR _ DRIVERINTERNALERROR
Interner Treiberfehler. Anwendungen sollten das Gerät zerstören und neu erstellen, wenn dieser Fehler auftritt. Hinweise zum Debuggen dieses Fehlers finden Sie unter Interne Treiberfehler (Direct3D 9).
D3DERR _ DRIVERINVALIDCALL
Wird nicht verwendet.
D3DERR _ INVALIDCALL
Der Methodenaufruf ist ungültig. Beispielsweise kann der Parameter einer Methode kein gültiger Zeiger sein.
D3DERR _ INVALIDDEVICE
Der angeforderte Gerätetyp ist ungültig.
D3DERR _ MOREDATA
Es sind mehr Daten verfügbar, als von der angegebenen Puffergröße gespeichert werden können.
D3DERR _ NICHT VERFÜGBAR
Dieses Gerät unterstützt die abgefragte Technik nicht.
D3DERR _ NOTFOUND
Das angeforderte Element wurde nicht gefunden.
D3D _ OK
Kein Fehler ist aufgetreten.
D3DERR _ OUTOFVIDEOMEMORY
Direct3D verfügt nicht über genügend Anzeigespeicher, um den Vorgang durchzuführen. Das Gerät verwendet mehr Ressourcen in einer einzelnen Szene, als gleichzeitig in den Videospeicher passen können. Present, PresentExoder CheckDeviceState können diesen Fehler zurückgeben. Die Wiederherstellung ähnelt D3DERR DEVICEHUNG, obwohl die Anwendung möglicherweise auch die Arbeitsspeicherauslastung pro Frame reduzieren möchte, um zu vermeiden, dass der _ Fehler erneut auftritt.
D3DERR _ TOOMANYOPERATIONS
Die Anwendung fordert mehr Texturfiltervorgänge an, als das Gerät unterstützt.
D3DERR _ UNSUPPORTED ALPHA WIEG
Das Gerät unterstützt kein angegebenes Texturmischungsargument für den Alphakanal.
D3DERR _ UNSUPPORTEDALPHAOPERATION
Das Gerät unterstützt keinen angegebenen Texturmischungsvorgang für den Alphakanal.
D3DERR _ UNSUPPORTEDCOLORARG
Das Gerät unterstützt kein angegebenes Texturmischungsargument für Farbwerte.
D3DERR _ UNSUPPORTEDCOLOROPERATION
Das Gerät unterstützt keinen angegebenen Texturmischungsvorgang für Farbwerte.
D3DERR _ UNSUPPORTEDFACTORVALUE
Das Gerät unterstützt den angegebenen Texturfaktorwert nicht. Nicht verwendet; wird nur zur Unterstützung älterer Treiber bereitgestellt.
D3DERR _ UNSUPPORTEDTEXTUREFILTER
Das Gerät unterstützt den angegebenen Texturfilter nicht.
D3DERR _ WAS BEGDRAWING
Der vorherige Blit-Vorgang, bei dem Informationen auf oder von dieser Oberfläche übertragen werden, ist unvollständig.
D3DERR _ WRONGTEXTUREFORMAT
Das Pixelformat der Texturoberfläche ist ungültig.
E _ FAIL
Im Direct3D-Subsystem ist ein unbestimmter Fehler aufgetreten.
E _ INVALIDARG
Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben.
E _ INVALIDCALL
Der Methodenaufruf ist ungültig. Beispielsweise kann der Parameter einer Methode einen ungültigen Wert haben.
E _ NOINTERFACE
Es ist keine Objektschnittstelle verfügbar.
E _ NOTIMPL
Nicht implementiert.
E _ OUTOFMEMORY
Direct3D konnte nicht genügend Arbeitsspeicher zuordnen, um den Aufruf abschließen zu können.
S _ OK
Kein Fehler ist aufgetreten.
S _ NOT _ RESIDENT
Mindestens eine Zuordnung, die die Ressourcen umfasst, befindet sich auf dem Datenträger. Nur Direct3D 9Ex.
S _ RESIDENT _ IN _ SHARED _ MEMORY
Es befinden sich keine Zuordnungen, aus denen die Ressourcen bestehen, auf dem Datenträger. Allerdings befindet sich mindestens eine Zuordnung nicht im GPU-zugänglichen Speicher. Nur Direct3D 9Ex.
S _ PRESENT _ MODE _ CHANGED
Der Desktopanzeigemodus wurde geändert. Die Anwendung kann weiterhin gerendert werden, aber es kann eine Farbkonvertierung/Stretching geben. Wählen Sie ein Backpufferformat ähnlich dem aktuellen Anzeigemodus aus, und rufen Sie Zurücksetzen auf, um die Austauschketten neu zu erstellen. Das Gerät verlässt diesen Zustand, nachdem reset aufgerufen wurde. Nur Direct3D 9Ex.
S _ PRESENT _ OCCLUDED
Der Präsentationsbereich ist verdeckt. Verdeckung bedeutet, dass das Präsentationsfenster minimiert wird oder ein anderes Gerät auf demselben Monitor wie das Präsentationsfenster in den Vollbildmodus wechselt und sich das Präsentationsfenster vollständig auf diesem Monitor befindet. Die Verdeckung tritt nicht auf, wenn der Clientbereich von einem anderen Fenster abgedeckt wird.
Occluded applications can continue rendering and all calls will succeed, but the occluded presentation window will not be updated. (Occluded applications can continue rendering and all calls will succeed, but the occluded presentation window will not be updated. Vorzugsweise sollte die Anwendung das Rendering im Präsentationsfenster mithilfe des Geräts beenden und CheckDeviceState aufrufen, bis S _ OK oder S PRESENT MODE CHANGED zurückgegeben _ _ _ wird.
Nur Direct3D 9Ex.
D3DERR _ UNSUPPORTEDOVERLAY
Das Gerät unterstützt keine Überlagerung für die angegebene Größe oder den Anzeigemodus.
Direct3D 9Ex unter Windows nur 7.
D3DERR _ UNSUPPORTEDOVERLAYFORMAT
Das Gerät unterstützt keine Überlagerung für das angegebene Oberflächenformat.
Direct3D 9Ex unter Windows nur 7.
D3DERR _ CANNOTPROTECTCONTENT
Der angegebene Inhalt kann nicht geschützt werden.
Direct3D 9Ex unter Windows nur 7.
D3DERR _ UNSUPPORTEDCRYPTO
Der angegebene kryptografische Algorithmus wird nicht unterstützt.
Direct3D 9Ex unter Windows nur 7.
D3DERR _ PRESENT _ STATISTICS _ DISJOINT
Die aktuelle Statistik weist keine geordnete Sequenz auf.
Direct3D 9Ex unter Windows nur 7.

Hinweise

Fehler werden durch negative Werte dargestellt und können nicht kombiniert werden.

Andere Rückgabecodes sind in S _ PRESENTenthalten.

Der Einrichtungscode _ FACD3D wird wie in den folgenden Makros verwendet, um Fehlercodes zu generieren.

// 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 )

Anforderungen

Anforderung Wert
Header
D3d9.h

Weitere Informationen

Direct3D-Konstanten