Auf Englisch lesen

Freigeben über


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