DirectDraw-Rückgabecodes

Fehler werden durch negative Werte dargestellt und können nicht kombiniert werden. In dieser Tabelle sind die Werte aufgeführt, die von allen Methoden der DirectDraw-Schnittstellen und DirectDraw-Funktionen zurückgegeben werden können. Eine Liste der Fehlercodes, die jede Methode oder Funktion zurückgeben kann, finden Sie in der Beschreibung der Methode oder Funktion.

DD_OK

Die Anforderung wurde erfolgreich abgeschlossen.

DDERR_ALREADYINITIALIZED

Das Objekt wurde bereits initialisiert.

DDERR_BLTFASTCANTCLIP

Ein DirectDrawClipper-Objekt wird an eine Quelloberfläche angefügt, die an einen Aufruf der IDirectDrawSurface7::BltFast-Methode übergeben wurde.

DDERR_CANNOTATTACHSURFACE

Eine Oberfläche kann nicht an einer anderen angeforderten Oberfläche angebracht werden.

DDERR_CANNOTDETACHSURFACE

Eine Oberfläche kann nicht von einer anderen angeforderten Oberfläche getrennt werden.

DDERR_CANTCREATEDC

Windows kann keine weiteren Gerätekontexte (DCs) erstellen, oder ein DC hat eine palettenindizierte Oberfläche angefordert, wenn die Oberfläche keine Palette hatte und der Anzeigemodus nicht palettenindiziert war (in diesem Fall kann DirectDraw keine richtige Palette im DC auswählen).

DDERR_CANTDUPLICATE

Primäre Und 3D-Oberflächen oder implizit erstellte Oberflächen können nicht dupliziert werden.

DDERR_CANTLOCKSURFACE

Der Zugriff auf diese Oberfläche wird verweigert, da versucht wurde, die primäre Oberfläche ohne DCI-Unterstützung (Display Control Interface) zu sperren.

DDERR_CANTPAGELOCK

Fehler beim Seitensperren einer Oberfläche. Die Seitensperre funktioniert nicht auf einer Anzeigespeicheroberfläche oder einer emulierten primären Oberfläche.

DDERR_CANTPAGEUNLOCK

Fehler beim Entsperren einer Oberfläche. Die Seitenentsperrung funktioniert nicht auf einer Anzeigespeicheroberfläche oder einer emulierten primären Oberfläche.

DDERR_CLIPPERISUSINGHWND

Es wurde versucht, eine Clipliste für ein DirectDrawClipper-Objekt festzulegen, das bereits ein Fensterhandle überwacht.

DDERR_COLORKEYNOTSET

Für diesen Vorgang wird kein Quellfarbschlüssel angegeben.

DDERR_CURRENTLYNOTAVAIL

Derzeit ist kein Support verfügbar.

DDERR_DDSCAPSCOMPLEXREQUIRED

Neu für DirectX 7.0. Für die Oberfläche ist das flag DDSCAPS_COMPLEX erforderlich.

DDERR_DCALREADYCREATED

Für diese Oberfläche wurde bereits ein Gerätekontext (Device Context, DC) zurückgegeben. Für jede Oberfläche kann nur ein DC abgerufen werden.

>DDERR_DEVICEDOESNTOWNSURFACE

Surfaces, die von einem DirectDraw-Gerät erstellt wurden, können nicht direkt von einem anderen DirectDraw-Gerät verwendet werden.

>DDERR_DIRECTDRAWALREADYCREATED

Für diesen Prozess wurde bereits ein DirectDraw-Objekt erstellt, das diesen Treiber darstellt.

DDERR_EXCEPTION

Beim Ausführen des angeforderten Vorgangs ist eine Ausnahme aufgetreten.

DDERR_EXCLUSIVEMODEALREADYSET

Es wurde versucht, die kooperative Ebene festzulegen, als sie bereits auf exklusiv festgelegt war.

DDERR_EXPIRED

Die Daten sind abgelaufen und daher nicht mehr gültig.

DDERR_GENERIC

Es gibt eine nicht definierte Fehlerbedingung.

DDERR_HEIGHTALIGN

Die Höhe des bereitgestellten Rechtecks ist kein Vielfaches der erforderlichen Ausrichtung.

DDERR_HWNDALREADYSET

Das DirectDraw-Fensterhandle auf kooperativer Ebene wurde bereits festgelegt. Es kann nicht zurückgesetzt werden, wenn für den Prozess Oberflächen oder Paletten erstellt wurden.

DDERR_HWNDSUBCLASSED

DirectDraw wird daran gehindert, den Zustand wiederherzustellen, da das DirectDraw-Fensterhandle auf kooperativer Ebene unterklassiert wurde.

DDERR_IMPLICITLYCREATED

Die Oberfläche kann nicht wiederhergestellt werden, da es sich um eine implizit erstellte Oberfläche handelt.

DDERR_INCOMPATIBLEPRIMARY

Die Primäre Oberflächenerstellungsanforderung stimmt nicht mit der vorhandenen primären Oberfläche überein.

DDERR_INVALIDCAPS

Mindestens eins der An die Rückruffunktion übergebenen Funktionsbits ist falsch.

DDERR_INVALIDCLIPLIST

DirectDraw unterstützt die bereitgestellte Clipliste nicht.

DDERR_INVALIDDIRECTDRAWGUID

Der an die DirectDrawCreate-Funktion übergebene globally unique identifier (GUID) ist kein gültiger DirectDraw-Treiberbezeichner.

DDERR_INVALIDMODE

DirectDraw unterstützt den angeforderten Modus nicht.

DDERR_INVALIDOBJECT

DirectDraw hat einen Zeiger empfangen, der ein ungültiges DirectDraw-Objekt war.

DDERR_INVALIDPARAMS

Mindestens ein parameter, der an die -Methode übergeben wird, ist falsch.

DDERR_INVALIDPIXELFORMAT

Das Pixelformat war wie angegeben ungültig.

DDERR_INVALIDPOSITION

Die Position der Überlagerung auf dem Ziel ist nicht mehr gültig.

DDERR_INVALIDRECT

Das angegebene Rechteck war ungültig.

DDERR_INVALIDSTREAM

Der angegebene Stream enthält ungültige Daten.

DDERR_INVALIDSURFACETYPE

Die Oberfläche hatte den falschen Typ.

DDERR_LOCKEDSURFACES

Mindestens eine Oberfläche ist gesperrt, was zum Ausfall des angeforderten Vorgangs führt.

DDERR_MOREDATA

Es sind mehr Daten verfügbar, als die angegebene Puffergröße enthalten kann.

DDERR_NEWMODE

Neu für DirectX 7.0. Wenn IDirectDraw7::StartModeTest mit dem flag DDSMT_ISTESTREQUIRED aufgerufen wird, kann dieser Wert zurückgegeben werden, um anzugeben, dass einige oder alle Der Auflösungen getestet werden können und sollten. IDirectDraw7::EvaluateMode gibt diesen Wert zurück, um anzugeben, dass der Test in einen neuen Anzeigemodus gewechselt ist.

DDERR_NO3D

Es ist keine 3D-Hardware oder Emulation vorhanden.

DDERR_NOALPHAHW

Es ist keine Alphabeschleunigungshardware vorhanden oder verfügbar, was den Fehler des angeforderten Vorgangs verursacht.

DDERR_NOBLTHW

Es ist kein Bitblock vorhanden, der Hardware übertragen wird.

DDERR_NOCLIPLIST

Es ist keine Clipliste verfügbar.

DDERR_NOCLIPPERATTACHED

An das Surface-Objekt ist kein DirectDrawClipper-Objekt angefügt.

DDERR_NOCOLORCONVHW

Es ist keine Farbkonvertierungshardware vorhanden oder verfügbar.

DDERR_NOCOLORKEY

Die Oberfläche verfügt derzeit nicht über einen Farbschlüssel.

DDERR_NOCOLORKEYHW

Es gibt keine Hardwareunterstützung für den Zielfarbschlüssel.

DDERR_NOCOOPERATIVELEVELSET

Eine create-Funktion wurde ohne die IDirectDraw7::SetCooperativeLevel-Methode aufgerufen.

DDERR_NODC

Für diese Oberfläche wurde noch kein Gerätekontext (DEVICE Context, DC) erstellt.

DDERR_NODDROPSHW

Es ist keine DirectDraw-ROP-Hardware (Raster-Operation) verfügbar.

DDERR_NODIRECTDRAWHW

Die Reine Hardware-DirectDraw-Objekterstellung ist nicht möglich. Der Treiber unterstützt keine Hardware.

DDERR_NODIRECTDRAWSUPPORT

DirectDraw-Unterstützung ist mit dem aktuellen Anzeigetreiber nicht möglich.

DDERR_NODRIVERSUPPORT

Neu für DirectX 7.0. Der Test kann nicht fortgesetzt werden, da der Grafikkartentreiber keine Aktualisierungsraten aufzählt.

DDERR_NOEMULATION

Die Softwareemulation ist nicht verfügbar.

DDERR_NOEXCLUSIVEMODE

Der Vorgang erfordert, dass die Anwendung über den exklusiven Modus verfügt, aber die Anwendung verfügt nicht über den exklusiven Modus.

DDERR_NOFLIPHW

Das Spiegeln sichtbarer Oberflächen wird nicht unterstützt.

DDERR_NOFOCUSWINDOW

Es wurde versucht, ein Gerätefenster zu erstellen oder festzulegen, ohne zuerst das Fokusfenster festzulegen.

DDERR_NOGDI

Es ist kein GDI vorhanden.

DDERR_NOHWND

Clipper-Benachrichtigung erfordert ein Fensterhandle, oder es wurde zuvor kein Fensterhandle als Fensterhandle auf Kooperativer Ebene festgelegt.

DDERR_NOMIPMAPHW

Es ist keine mipmap-fähige Texturzuordnungshardware vorhanden oder verfügbar.

DDERR_NOMIRRORHW

Es ist keine Spiegelungshardware vorhanden oder verfügbar.

DDERR_NOMONITORINFORMATION

Neu für DirectX 7.0. Der Test kann nicht fortgesetzt werden, da dem Monitor keine EDID-Daten zugeordnet sind.

DDERR_NONONLOCALVIDMEM

Es wurde versucht, nichtlokalen Videospeicher von einem Gerät zuzuweisen, das nicht den nichtlokalen Videospeicher unterstützt.

DDERR_NOOPTIMIZEHW

Das Gerät unterstützt keine optimierten Oberflächen.

DDERR_NOOVERLAYDEST

Die IDirectDrawSurface7::GetOverlayPosition-Methode wird für eine Überlagerung aufgerufen, für die die IDirectDrawSurface7::UpdateOverlay-Methode nicht aufgerufen wurde, um als Ziel festzulegen.

DDERR_NOOVERLAYHW

Es ist keine Überlagerungshardware vorhanden oder verfügbar.

DDERR_NOPALETTEATTACHED

An diese Oberfläche ist kein Palettenobjekt angefügt.

DDERR_NOPALETTEHW

Es gibt keine Hardwareunterstützung für 16- oder 256-Farbpaletten.

DDERR_NORASTEROPHW

Es ist keine geeignete Rasterbetriebshardware vorhanden oder verfügbar.

DDERR_NOROTATIONHW

Es ist keine Rotationshardware vorhanden oder verfügbar.

DDERR_NOSTEREOHARDWARE

Es ist keine Stereohardware vorhanden oder verfügbar.

DDERR_NOSTRETCHHW

Es gibt keine Hardwareunterstützung für das Dehnen.

DDERR_NOSURFACELEFT

Es ist keine Hardware vorhanden, die Stereooberflächen unterstützt.

DDERR_NOT4BITCOLOR

Das DirectDrawSurface-Objekt verwendet keine 4-Bit-Farbpalette, und der angeforderte Vorgang erfordert eine 4-Bit-Farbpalette.

DDERR_NOT4BITCOLORINDEX

Das DirectDrawSurface-Objekt verwendet keine 4-Bit-Farbindexpalette, und der angeforderte Vorgang erfordert eine 4-Bit-Farbindexpalette.

DDERR_NOT8BITCOLOR

Das DirectDrawSurface-Objekt verwendet keine 8-Bit-Farbpalette, und der angeforderte Vorgang erfordert eine 8-Bit-Farbpalette.

DDERR_NOTAOVERLAYSURFACE

Eine Überlagerungskomponente wird für eine Oberfläche ohne Überlagerung aufgerufen.

DDERR_NOTEXTUREHW

Der Vorgang kann nicht ausgeführt werden, da keine Texturzuordnungshardware vorhanden oder verfügbar ist.

DDERR_NOTFLIPPABLE

Es wurde versucht, eine Oberfläche umzudrehen, die nicht gekippt werden kann.

DDERR_NOTFOUND

Das angeforderte Element wurde nicht gefunden.

DDERR_NOTINITIALIZED

Es wurde versucht, eine Schnittstellenmethode eines DirectDraw-Objekts aufzurufen, das von CoCreateInstance erstellt wurde, bevor das Objekt initialisiert wurde.

DDERR_NOTLOADED

Die Oberfläche ist eine optimierte Oberfläche, aber es wurde noch kein Arbeitsspeicher zugewiesen.

DDERR_NOTLOCKED

Es wurde versucht, eine nicht gesperrte Oberfläche zu entsperren.

DDERR_NOTPAGELOCKED

Es wurde versucht, eine Oberfläche ohne ausstehende Seitensperren zu entsperren.

DDERR_NOTPALETTIZED

Die verwendete Oberfläche ist keine palettenbasierte Oberfläche.

DDERR_NOVSYNCHW

Es gibt keine Hardwareunterstützung für vertikale leere synchronisierte Vorgänge.

DDERR_NOZBUFFERHW

Der Vorgang zum Erstellen eines Z-Puffers im Anzeigespeicher oder zum Durchführen einer Bitblockübertragung (Bitblt) mit einem Z-Puffer kann nicht ausgeführt werden, da keine Hardwareunterstützung für Z-Puffer vorhanden ist.

DDERR_NOZOVERLAYHW

Die Überlagerungsflächen können nicht z-schichtweise basierend auf der Z-Reihenfolge ausgeführt werden, da die Hardware die Z-Reihenfolge von Überlagerungen nicht unterstützt.

DDERR_OUTOFCAPS

Die für den angeforderten Vorgang erforderliche Hardware wurde bereits zugeordnet.

DDERR_OUTOFMEMORY

DirectDraw verfügt nicht über genügend Arbeitsspeicher, um den Vorgang auszuführen.

DDERR_OUTOFVIDEOMEMORY

DirectDraw verfügt nicht über genügend Anzeigespeicher, um den Vorgang auszuführen.

DDERR_OVERLAPPINGRECTS

Die Quell- und Zielrechtecke befinden sich auf derselben Oberfläche und überlappen sich.

DDERR_OVERLAYCANTCLIP

Die Hardware unterstützt keine beschnittenen Überlagerungen.

DDERR_OVERLAYCOLORKEYONLYONEACTIVE

Es wurde versucht, mehrere Farbtasten auf einer Überlagerung aktiv zu haben.

DDERR_OVERLAYNOTVISIBLE

Die IDirectDrawSurface7::GetOverlayPosition-Methode wurde für eine ausgeblendete Überlagerung aufgerufen.

DDERR_PALETTEBUSY

Der Zugriff auf diese Palette wird verweigert, weil die Palette durch einen anderen Thread gesperrt ist.

DDERR_PRIMARYSURFACEALREADYEXISTS

Dieser Prozess hat bereits eine primäre Oberfläche erstellt.

DDERR_REGIONTOOSMALL

Der an die IDirectDrawClipper::GetClipList-Methode übergebene Bereich ist zu klein.

DDERR_SURFACEALREADYATTACHED

Es wurde versucht, eine Oberfläche an einer anderen Oberfläche anzubringen, an der sie bereits befestigt ist.

DDERR_SURFACEALREADYDEPENDENT

Es wurde versucht, eine Oberfläche als Abhängigkeit von einer anderen Oberfläche zu machen, von der sie bereits abhängig ist.

DDERR_SURFACEBUSY

Der Zugriff auf die Oberfläche wird verweigert, weil die Oberfläche durch einen anderen Thread gesperrt ist.

DDERR_SURFACEISOBSCURED

Der Zugriff auf die Oberfläche wird verweigert, weil die Oberfläche verdeckt ist.

DDERR_SURFACELOST

Der Zugriff auf die Oberfläche wird verweigert, weil der Oberflächenspeicher nicht mehr vorhanden ist. Rufen Sie die IDirectDrawSurface7::Restore-Methode auf dieser Oberfläche auf, um den zugeordneten Arbeitsspeicher wiederherzustellen.

DDERR_SURFACENOTATTACHED

Die angeforderte Oberfläche ist nicht angefügt.

DDERR_TESTFINISHED

Neu für DirectX 7.0. Wenn er von der IDirectDraw7::StartModeTest-Methode zurückgegeben wird, bedeutet dieser Wert, dass kein Test initiiert werden konnte, da alle für tests ausgewählten Auflösungen bereits Informationen zur Aktualisierungsrate in der Registrierung enthalten. Wenn er von IDirectDraw7::EvaluateMode zurückgegeben wird, bedeutet der Wert, dass DirectDraw einen Aktualisierungsratetest abgeschlossen hat.

DDERR_TOOBIGHEIGHT

Die von DirectDraw angeforderte Höhe ist zu groß.

DDERR_TOOBIGSIZE

Die von DirectDraw angeforderte Größe ist zu groß. Die einzelnen Höhe und Breite sind jedoch gültige Größen.

DDERR_TOOBIGWIDTH

Die von DirectDraw angeforderte Breite ist zu groß.

DDERR_UNSUPPORTED

Der Vorgang wird nicht unterstützt.

DDERR_UNSUPPORTEDFORMAT

Das angeforderte Pixelformat wird von DirectDraw nicht unterstützt.

DDERR_UNSUPPORTEDMASK

Die Bitmaske im angeforderten Pixelformat wird von DirectDraw nicht unterstützt.

DDERR_UNSUPPORTEDMODE

Die Anzeige befindet sich derzeit in einem nicht unterstützten Modus.

DDERR_VERTICALBLANKINPROGRESS

Ein vertikaler Leerstand wird ausgeführt.

DDERR_VIDEONOTACTIVE

Der Videoport ist nicht aktiv.

DDERR_WASSTILLDRAWING

Der vorherige Bitblt-Vorgang, der Informationen an oder von dieser Oberfläche überträgt, ist unvollständig.

DDERR_WRONGMODE

Diese Oberfläche kann nicht wiederhergestellt werden, da sie in einem anderen Modus erstellt wurde.

DDERR_XALIGN

Das bereitgestellte Rechteck wurde nicht horizontal an einer erforderlichen Grenze ausgerichtet.

Anforderungen

Anforderung	Wert
Header	Ddraw.h