Freigeben über


DXGI_ERROR

Fehlercodes, die von einer DXGI-Funktion zurückgegeben werden können.

Konstante/Wert BESCHREIBUNG
DXGI_ERROR_ACCESS_DENIED
0x887A002B
Sie haben versucht, eine Ressource zu verwenden, für die Sie nicht über die erforderlichen Zugriffsberechtigungen verfügten. Dieser Fehler wird in der Regel beim Schreiben in eine freigegebene Ressource mit schreibgeschütztem Zugriff verursacht.
DXGI_ERROR_ACCESS_LOST
0x887A0026
Die Desktopduplizierungsschnittstelle ist ungültig. Die Desktopduplizierungsschnittstelle wird in der Regel ungültig, wenn ein anderer Bildtyp auf dem Desktop angezeigt wird.
DXGI_ERROR_ALREADY_EXISTS
0x887A0036L
Das gewünschte Element ist bereits vorhanden. Dies wird von DXGIDeclareAdapterRemovalSupport zurückgegeben, wenn es nicht das erste Mal ist, dass die Funktion aufgerufen wird.
DXGI_ERROR_CANNOT_PROTECT_CONTENT
0x887A002A
DXGI kann keinen Inhaltsschutz für die Swapchain bereitstellen. Dieser Fehler wird in der Regel durch einen älteren Treiber verursacht oder wenn Sie eine Swapchain verwenden, die nicht mit dem Inhaltsschutz kompatibel ist.
DXGI_ERROR_DEVICE_HUNG
0x887A0006
Das Gerät der Anwendung ist aufgrund falsch gebildeter Befehle fehlgeschlagen, die von der Anwendung gesendet wurden. Dies ist ein Entwurfszeitproblem, das untersucht und behoben werden sollte.
DXGI_ERROR_DEVICE_REMOVED
0x887A0005
Die Grafikkarte wurde physisch aus dem System entfernt, oder es ist ein Treiberupgrade für die Grafikkarte aufgetreten. Die Anwendung sollte das Gerät zerstören und neu erstellen. Rufen Sie ID3D10Device::GetDeviceRemovedReason auf, um Hilfe beim Debuggen des Problems zu erhalten.
DXGI_ERROR_DEVICE_RESET
0x887A0007
Das Gerät konnte aufgrund eines fehlerhaften Befehls nicht ausgeführt werden. Dies ist ein Laufzeitproblem; Die Anwendung sollte das Gerät zerstören und neu erstellen.
DXGI_ERROR_DRIVER_INTERNAL_ERROR
0x887A0020
Der Treiber hat ein Problem festgestellt und wurde in den Zustand "Gerät entfernt" versetzt.
DXGI_ERROR_FRAME_STATISTICS_DISJOINT
0x887A000B
Ein Ereignis (z. B. ein Stromzyklus) hat das Sammeln von Präsentationsstatistiken unterbrochen.
DXGI_ERROR_GRAPHICS_VIDPN_SOURCE_IN_USE
0x887A000C
Die Anwendung hat versucht, den exklusiven Besitz einer Ausgabe zu erwerben, ist jedoch fehlgeschlagen, da eine andere Anwendung (oder ein Gerät innerhalb der Anwendung) bereits Besitz erworben hat.
DXGI_ERROR_INVALID_CALL
0x887A0001
Die Anwendung hat ungültige Parameterdaten bereitgestellt; dies muss gedebuggt und behoben werden, bevor die Anwendung freigegeben wird.
DXGI_ERROR_MORE_DATA
0x887A0003
Der von der Anwendung bereitgestellte Puffer ist nicht groß genug, um die angeforderten Daten zu enthalten.
DXGI_ERROR_NAME_ALREADY_EXISTS
0x887A002C
Der angegebene Name einer Ressource in einem Aufruf von IDXGIResource1::CreateSharedHandle ist bereits einer anderen Ressource zugeordnet.
DXGI_ERROR_NONEXCLUSIVE
0x887A0021
Eine globale Zählerressource wird verwendet, und das Direct3D-Gerät kann derzeit die Zählerressource nicht verwenden.
DXGI_ERROR_NOT_CURRENTLY_AVAILABLE
0x887A0022
Die Ressource oder Anforderung ist derzeit nicht verfügbar, kann aber später verfügbar werden.
DXGI_ERROR_NOT_FOUND
0x887A0002
Beim Aufrufen von IDXGIObject::GetPrivateData wird die übergebene GUID nicht als zuvor an IDXGIObject::SetPrivateData oder IDXGIObject::SetPrivateDataInterface übergebene GUID erkannt. Beim Aufrufen von IDXGIFactory::EnumAdapters oder IDXGIAdapter::EnumOutputs liegt das aufgezählte Ordinal außerhalb des Zulässigen.
DXGI_ERROR_REMOTE_CLIENT_DISCONNECTED
0x887A0023
Reserviert
DXGI_ERROR_REMOTE_OUTOFMEMORY
0x887A0024
Reserviert
DXGI_ERROR_RESTRICT_TO_OUTPUT_STALE
0x887A0029
Die DXGI-Ausgabe (Monitor), auf die der Swapchaininhalt eingeschränkt wurde, wird jetzt getrennt oder geändert.
DXGI_ERROR_SDK_COMPONENT_MISSING
0x887A002D
Der Vorgang hängt von einer SDK-Komponente ab, die fehlt oder nicht übereinstimmend ist.
DXGI_ERROR_SESSION_DISCONNECTED
0x887A0028
Die Remotedesktopdienste-Sitzung ist zurzeit getrennt.
DXGI_ERROR_UNSUPPORTED
0x887A0004
Die angeforderte Funktionalität wird vom Gerät oder treiber nicht unterstützt.
DXGI_ERROR_WAIT_TIMEOUT
0x887A0027
Das Timeoutintervall, das abgelaufen ist, bevor der nächste Desktopframe verfügbar war.
DXGI_ERROR_WAS_STILL_DRAWING
0x887A000A
Die GPU war zum Zeitpunkt der Ausführung eines Vorgangs beschäftigt und hat den Vorgang nicht ausgeführt oder geplant.
S_OK
Die Methode war ohne Fehler erfolgreich.

Bemerkungen

Möglicherweise sind Sie nur daran interessiert, ob die Methode erfolgreich war oder fehlgeschlagen ist. Die beste Methode, um zu testen, ob ein HRESULT-Wert erfolg oder fehlgeschlagen ist, besteht darin, den Wert an eins der folgenden Makros zu übergeben, die in WinError.h definiert sind:

  • Das SUCCEEDED-Makro gibt WAHR für einen Erfolgscode und FALSE für einen Fehlercode zurück.
  • Das MAKRO FAILED gibt WAHR für einen Fehlercode und FALSE für einen Erfolgscode zurück.

Der HRESULT-Wert für jeden DXGI_ERROR-Wert wird aus diesem Makro bestimmt, das in DXGItype.h definiert ist:

#define _FACDXGI    0x87a
#define MAKE_DXGI_HRESULT(code) MAKE_HRESULT(1, _FACDXGI, code)

Beispielsweise wird DXGI_ERROR_INVALID_CALL als 0x887A0001 definiert:

#define DXGI_ERROR_INVALID_CALL                 MAKE_DXGI_HRESULT(1)

Anforderungen

Anforderung Wert
Kopfzeile
Winerror.h

Siehe auch

DXGI-Konstanten