DXGI_ERROR

  • Artikel

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 die Funktion nicht zum ersten Mal 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 mit dem Inhaltsschutz nicht kompatibel ist.
DXGI_ERROR_DEVICE_HUNG
0x887A0006
 Das Gerät der Anwendung ist aufgrund falsch formatierter Befehle fehlgeschlagen, die von der Anwendung gesendet wurden. Dies ist ein Problem zur Entwurfszeit, das untersucht und behoben werden sollte.
DXGI_ERROR_DEVICE_REMOVED
0x887A0005
 Das Video Karte wurde physisch aus dem System entfernt, oder es wurde ein Treiberupgrade für das Video Karte durchgeführt. 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
 Fehler beim Gerät aufgrund eines falsch formatierten Befehls. Dies ist ein Laufzeitproblem. Die Anwendung sollte das Gerät zerstören und neu erstellen.
DXGI_ERROR_DRIVER_INTERNAL_ERROR
0x887A0020
 Der Treiber ist auf ein Problem gestoßen und wurde in den Zustand entfernt des Geräts 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 bereits eine andere Anwendung (oder ein Gerät innerhalb der Anwendung) den Besitz erworben hat.
DXGI_ERROR_INVALID_CALL
0x887A0001
 Die Anwendung hat ungültige Parameterdaten bereitgestellt. Dies muss vor der Veröffentlichung der Anwendung debuggt und behoben werden.
DXGI_ERROR_MORE_DATA
0x887A0003
 Der von der Anwendung bereitgestellte Puffer ist nicht groß genug, um die angeforderten Daten aufzunehmen.
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 die Zählerressource derzeit nicht verwenden.
DXGI_ERROR_NOT_CURRENTLY_AVAILABLE
0x887A0022
 Die Ressource oder Anforderung ist derzeit nicht verfügbar, wird aber möglicherweise später verfügbar.
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 die enumerierte Ordnungszahl außerhalb des Bereichs.
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 beschränkt war, 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 derzeit 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 ist abgelaufen, bevor der nächste Desktopframe verfügbar war.
DXGI_ERROR_WAS_STILL_DRAWING
0x887A000A
 Die GPU war zu dem Zeitpunkt ausgelastet, zu dem ein Aufruf zum Ausführen eines Vorgangs erfolgte, und der Vorgang wurde nicht ausgeführt oder geplant.
S_OK
 Die Methode war ohne Fehler erfolgreich.

Bemerkungen

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

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

Der HRESULT-Wert für jeden DXGI_ERROR Wert wird anhand dieses Makros 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
Header
Winerror.h

Siehe auch

DXGI-Konstanten