D3DERR

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

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, aber die mipmap-Ebenen nicht automatisch generiert werden.
D3DERR_CONFLICTINGRENDERSTATE	Die aktuell 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, hat dazu geführt, dass der Hardwareadapter vom Betriebssystem zurückgesetzt wurde. Die meisten Anwendungen sollten das Gerät zerstören und beenden. Anwendungen, die fortgesetzt werden müssen, sollten alle Videospeicherobjekte (Oberflächen, Texturen, Zustandsblöcke usw.) zerstören und Reset() aufrufen, um das Gerät in einen Standardzustand zu versetzen. Wenn die Anwendung das Rendern dann auf die gleiche Weise fortsetzt, kehrt das Gerät in diesen Zustand zurück. Gilt nur für Direct3D 9Ex.
D3DERR_DEVICELOST	Das Gerät ist verloren gegangen, kann aber zu diesem Zeitpunkt nicht zurückgesetzt werden. Daher ist das Rendern nicht möglich. Ein anderes Direct3D-Geräteobjekt als das, das diesen Code zurückgegeben hat, hat dazu geführt, 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 Rendern ohne Zurücksetzen fortsetzt, werden die Renderingaufrufe erfolgreich ausgeführt.
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, eine Enumeration von Adaptern durchführen und ein weiteres Direct3D-Gerät erstellen. Wenn die Anwendung das Rendern ohne Aufrufen von Reset fortsetzt, werden die Renderingaufrufe erfolgreich ausgeführt. Gilt nur für Direct3D 9Ex.
D3DERR_DRIVERINTERNALERROR	Interner Treiberfehler. Anwendungen sollten das Gerät zerstören und neu erstellen, wenn dieser Fehler empfangen wird. Hinweise zum Debuggen dieses Fehlers finden Sie unter Treiberinterne Fehler (Direct3D 9).
D3DERR_DRIVERINVALIDCALL	Wird nicht verwendet.
D3DERR_INVALIDCALL	Der Methodenaufruf ist ungültig. Beispielsweise ist der Parameter einer Methode möglicherweise kein gültiger Zeiger.
D3DERR_INVALIDDEVICE	Der angeforderte Gerätetyp ist ungültig.
D3DERR_MOREDATA	Es sind mehr Daten verfügbar, als die angegebene Puffergröße enthalten kann.
D3DERR_NOTAVAILABLE	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 auszuführen. Das Gerät benötigt mehr Ressourcen in einer einzelnen Szene, als gleichzeitig in den Videospeicher passen kann. Present, PresentEx oder 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_UNSUPPORTEDALPHAARG	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 bereitgestellt, um ältere Treiber zu unterstützen.
D3DERR_UNSUPPORTEDTEXTUREFILTER	Das Gerät unterstützt den angegebenen Texturfilter nicht.
D3DERR_WASSTILLDRAWING	Der vorherige blit-Vorgang, der Informationen an oder von dieser Oberfläche überträgt, ist unvollständig.
D3DERR_WRONGTEXTUREFORMAT	Das Pixelformat der Texturoberfläche ist ungültig.
E_FAIL	Innerhalb des Direct3D-Subsystems ist ein nicht festgelegter 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 aufweisen.
E_NOINTERFACE	Es ist keine Objektschnittstelle verfügbar.
E_NOTIMPL	Nicht implementiert.
E_OUTOFMEMORY	Direct3D konnte nicht genügend Arbeitsspeicher zuweisen, um den Aufruf abzuschließen.
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	Auf dem Datenträger befinden sich keine Zuordnungen, die die Ressourcen umfassen. Mindestens eine Zuordnung befindet sich jedoch nicht im Speicher, auf den GPU zugegriffen werden kann. Nur Direct3D 9Ex.
S_PRESENT_MODE_CHANGED	Der Desktopanzeigemodus wurde geändert. Die Anwendung kann das Rendern fortsetzen, es kann jedoch zu Farbkonvertierungen/-dehnungen kommen. Wählen Sie ein Zurückpufferformat aus, das dem aktuellen Anzeigemodus ähnelt, und rufen Sie Zurücksetzen auf, um die Swapchains neu zu erstellen. Das Gerät verlässt diesen Zustand, nachdem ein Zurücksetzen aufgerufen wurde. Nur Direct3D 9Ex.
S_PRESENT_OCCLUDED	Der Präsentationsbereich ist verworren. Okklusion 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. Verworrene Anwendungen können weiterhin gerendert werden, und alle Aufrufe sind erfolgreich, aber das fenster mit der verschließten Präsentation wird nicht aktualisiert. Vorzugsweise sollte die Anwendung das Rendern im Präsentationsfenster mit dem Gerät beenden und CheckDeviceState weiterhin 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 angegebenen Anzeigemodus. Direct3D 9Ex nur unter Windows 7.
D3DERR_UNSUPPORTEDOVERLAYFORMAT	Das Gerät unterstützt keine Überlagerung für das angegebene Oberflächenformat. Direct3D 9Ex nur unter Windows 7.
D3DERR_CANNOTPROTECTCONTENT	Der angegebene Inhalt kann nicht geschützt werden. Direct3D 9Ex nur unter Windows 7.
D3DERR_UNSUPPORTEDCRYPTO	Der angegebene kryptografische Algorithmus wird nicht unterstützt. Direct3D 9Ex nur unter Windows 7.
D3DERR_PRESENT_STATISTICS_DISJOINT	Die vorliegenden Statistiken weisen keine geordnete Sequenz auf. Direct3D 9Ex nur unter Windows 7.

Bemerkungen

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

Andere Rückgabecodes sind in S_PRESENT enthalten.

Der Einrichtungscode _FACD3D wird verwendet, um Fehlercodes zu generieren, wie in den folgenden Makros dargestellt.

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

Siehe auch

Direct3D-Konstanten