Codes de retour DirectDraw

Les erreurs sont représentées par des valeurs négatives et ne peuvent pas être combinées. Ce tableau répertorie les valeurs qui peuvent être retournées par toutes les méthodes des interfaces DirectDraw et des fonctions DirectDraw. Pour obtenir la liste des codes d’erreur que chaque méthode ou fonction peut retourner, consultez la description de la méthode ou de la fonction.

DD_OK

La demande s’est terminée avec succès.

DDERR_ALREADYINITIALIZED

L’objet a déjà été initialisé.

DDERR_BLTFASTCANTCLIP

Un objet DirectDrawClipper est attaché à une surface source passée dans un appel à la méthode IDirectDrawSurface7::BltFast .

DDERR_CANNOTATTACHSURFACE

Une surface ne peut pas être attachée à une autre surface demandée.

DDERR_CANNOTDETACHSURFACE

Une surface ne peut pas être détachée d’une autre surface demandée.

DDERR_CANTCREATEDC

Windows ne peut pas créer d’autres contextes d’appareil ou un contrôleur de domaine a demandé une surface indexée par palette lorsque la surface n’avait pas de palette et que le mode d’affichage n’était pas indexé par palette (dans ce cas, DirectDraw ne peut pas sélectionner une palette appropriée dans le contrôleur de domaine).

DDERR_CANTDUPLICATE

Les surfaces principales et 3D, ou surfaces créées implicitement, ne peuvent pas être dupliquées.

DDERR_CANTLOCKSURFACE

L’accès à cette surface est refusé car une tentative de verrouillage de la surface principale a été effectuée sans prise en charge de l’interface de contrôle d’affichage (DCI).

DDERR_CANTPAGELOCK

Une tentative de verrouillage de page d’une surface a échoué. Le verrouillage de page ne fonctionne pas sur une surface d’affichage en mémoire ou une surface principale émulée.

DDERR_CANTPAGEUNLOCK

Une tentative de déverrouillage de page d’une surface a échoué. Le déverrouillage de page ne fonctionne pas sur une surface d’affichage en mémoire ou une surface principale émulée.

DDERR_CLIPPERISUSINGHWND

Une tentative a été effectuée pour définir une liste de clips pour un objet DirectDrawClipper qui surveille déjà un handle de fenêtre.

DDERR_COLORKEYNOTSET

Aucune clé de couleur source n’est spécifiée pour cette opération.

DDERR_CURRENTLYNOTAVAIL

Aucune prise en charge n’est actuellement disponible.

DDERR_DDSCAPSCOMPLEXREQUIRED

Nouveauté de DirectX 7.0. La surface nécessite l’indicateur DDSCAPS_COMPLEX.

DDERR_DCALREADYCREATED

Un contexte d’appareil (DC) a déjà été retourné pour cette surface. Un seul contrôleur de domaine peut être récupéré pour chaque surface.

>DDERR_DEVICEDOESNTOWNSURFACE

Les Surfaces créées par un appareil DirectDraw ne peuvent pas être utilisées directement par un autre appareil DirectDraw.

>DDERR_DIRECTDRAWALREADYCREATED

Un objet DirectDraw représentant ce pilote a déjà été créé pour ce processus.

DDERR_EXCEPTION

Une exception a été rencontrée lors de l’exécution de l’opération demandée.

DDERR_EXCLUSIVEMODEALREADYSET

On a tenté de définir le niveau de coopération alors qu’il était déjà défini sur exclusif.

DDERR_EXPIRED

Les données ont expiré et ne sont donc plus valides.

DDERR_GENERIC

Il existe une condition d’erreur non définie.

DDERR_HEIGHTALIGN

La hauteur du rectangle fourni n’est pas un multiple de l’alignement requis.

DDERR_HWNDALREADYSET

Le handle de fenêtre de niveau coopératif DirectDraw a déjà été défini. Il ne peut pas être réinitialisé tant que des surfaces ou des palettes ont été créées dans le processus.

DDERR_HWNDSUBCLASSED

DirectDraw ne peut pas restaurer l’état, car le handle de fenêtre de niveau coopératif DirectDraw a été sous-classé.

DDERR_IMPLICITLYCREATED

Impossible de restaurer la surface, car il s’agit d’une surface créée implicitement.

DDERR_INCOMPATIBLEPRIMARY

La demande de création de surface primaire ne correspond pas à la surface primaire existante.

DDERR_INVALIDCAPS

Un ou plusieurs des bits de capacité passés à la fonction de rappel sont incorrects.

DDERR_INVALIDCLIPLIST

DirectDraw ne prend pas en charge la liste de clips fournie.

DDERR_INVALIDDIRECTDRAWGUID

L’identificateur global unique (GUID) passé à la fonction DirectDrawCreate n’est pas un identificateur de pilote DirectDraw valide.

DDERR_INVALIDMODE

DirectDraw ne prend pas en charge le mode demandé.

DDERR_INVALIDOBJECT

DirectDraw a reçu un pointeur qui était un objet DirectDraw non valide.

DDERR_INVALIDPARAMS

Un ou plusieurs des paramètres passés à la méthode sont incorrects.

DDERR_INVALIDPIXELFORMAT

Le format de pixel n’était pas valide comme spécifié.

DDERR_INVALIDPOSITION

La position de la superposition sur la destination n’est plus valide.

DDERR_INVALIDRECT

Le rectangle fourni n’était pas valide.

DDERR_INVALIDSTREAM

Le flux spécifié contient des données non valides.

DDERR_INVALIDSURFACETYPE

La surface était du mauvais type.

DDERR_LOCKEDSURFACES

Une ou plusieurs surfaces sont verrouillées, ce qui entraîne l’échec de l’opération demandée.

DDERR_MOREDATA

Il y a plus de données disponibles que la taille de mémoire tampon spécifiée peut contenir.

DDERR_NEWMODE

Nouveauté de DirectX 7.0. Lorsque IDirectDraw7::StartModeTest est appelé avec l’indicateur DDSMT_ISTESTREQUIRED, il peut retourner cette valeur pour indiquer que certaines ou toutes les résolutions peuvent et doivent être testées. IDirectDraw7::EvaluateMode retourne cette valeur pour indiquer que le test a basculé vers un nouveau mode d’affichage.

DDERR_NO3D

Aucun matériel 3D ou émulation n’est présent.

DDERR_NOALPHAHW

Aucun matériel d’accélération alpha n’est présent ou disponible, ce qui entraîne l’échec de l’opération demandée.

DDERR_NOBLTHW

Aucun bloc de bits de transfert de matériel n’est présent.

DDERR_NOCLIPLIST

Aucune liste de clip n’est disponible.

DDERR_NOCLIPPERATTACHED

Aucun objet DirectDrawClipper n’est attaché à l’objet surface.

DDERR_NOCOLORCONVHW

Aucun matériel de conversion de couleur n’est présent ou disponible.

DDERR_NOCOLORKEY

La surface n’a actuellement pas de clé de couleur.

DDERR_NOCOLORKEYHW

Il n’existe aucune prise en charge matérielle pour la clé de couleur de destination.

DDERR_NOCOOPERATIVELEVELSET

Une fonction create a été appelée sans la méthode IDirectDraw7::SetCooperativeLevel .

DDERR_NODC

Aucun contexte d’appareil (DC) n’a jamais été créé pour cette surface.

DDERR_NODDROPSHW

Aucun matériel DirectDraw raster-operation (ROP) n’est disponible.

DDERR_NODIRECTDRAWHW

La création d’objets DirectDraw uniquement sur le matériel n’est pas possible; le pilote ne prend pas en charge le matériel.

DDERR_NODIRECTDRAWSUPPORT

La prise en charge de DirectDraw n’est pas possible avec le pilote d’affichage actuel.

DDERR_NODRIVERSUPPORT

Nouveauté de DirectX 7.0. Impossible de procéder au test, car le pilote de la carte graphique n’énumère pas les taux d’actualisation.

DDERR_NOEMULATION

L’émulation logicielle n’est pas disponible.

DDERR_NOEXCLUSIVEMODE

L’opération nécessite que l’application ait un mode exclusif, mais l’application n’a pas de mode exclusif.

DDERR_NOFLIPHW

Le glissement des surfaces visibles n’est pas pris en charge.

DDERR_NOFOCUSWINDOW

Une tentative de création ou de définition d’une fenêtre d’appareil a été effectuée sans définir au préalable la fenêtre de focus.

DDERR_NOGDI

Aucun GDI n’est présent.

DDERR_NOHWND

La notification Clipper nécessite un handle de fenêtre, ou aucun handle de fenêtre n’a été précédemment défini comme handle de fenêtre de niveau coopératif.

DDERR_NOMIPMAPHW

Aucun matériel de mappage de texture prenant en charge mipmap n’est présent ou disponible.

DDERR_NOMIRRORHW

Aucun matériel de mise en miroir n’est présent ou disponible.

DDERR_NOMONITORINFORMATION

Nouveauté de DirectX 7.0. Impossible de procéder au test, car le moniteur n’a pas de données EDID associées.

DDERR_NONONLOCALVIDMEM

Une tentative a été effectuée pour allouer de la mémoire vidéo non locale à partir d’un appareil qui ne prend pas en charge la mémoire vidéo non locale.

DDERR_NOOPTIMIZEHW

L’appareil ne prend pas en charge les surfaces optimisées.

DDERR_NOOVERLAYDEST

La méthode IDirectDrawSurface7::GetOverlayPosition est appelée sur une superposition que la méthode IDirectDrawSurface7::UpdateOverlay n’a pas été appelée pour établir comme destination.

DDERR_NOOVERLAYHW

Aucun matériel de superposition n’est présent ou disponible.

DDERR_NOPALETTEATTACHED

Aucun objet de palette n’est attaché à cette surface.

DDERR_NOPALETTEHW

Il n’existe aucune prise en charge matérielle pour les palettes de couleurs 16 ou 256.

DDERR_NORASTEROPHW

Aucun matériel d’opération raster approprié n’est présent ou disponible.

DDERR_NOROTATIONHW

Aucun matériel de rotation n’est présent ou disponible.

DDERR_NOSTEREOHARDWARE

Aucun matériel stéréo n’est présent ou disponible.

DDERR_NOSTRETCHHW

Il n’existe aucune prise en charge matérielle pour l’étirement.

DDERR_NOSURFACELEFT

Aucun matériel ne prend en charge les surfaces stéréo.

DDERR_NOT4BITCOLOR

L’objet DirectDrawSurface n’utilise pas une palette de couleurs 4 bits, et l’opération demandée nécessite une palette de couleurs 4 bits.

DDERR_NOT4BITCOLORINDEX

L’objet DirectDrawSurface n’utilise pas une palette d’index de couleurs 4 bits, et l’opération demandée nécessite une palette d’index de couleurs 4 bits.

DDERR_NOT8BITCOLOR

L’objet DirectDrawSurface n’utilise pas une palette de couleurs 8 bits, et l’opération demandée nécessite une palette de couleurs 8 bits.

DDERR_NOTAOVERLAYSURFACE

Un composant de superposition est appelé pour une surface non superposée.

DDERR_NOTEXTUREHW

L’opération ne peut pas être effectuée, car aucun matériel de mappage de textures n’est présent ou disponible.

DDERR_NOTFLIPPABLE

Une tentative a été effectuée pour retourner une surface qui ne peut pas être retournée.

DDERR_NOTFOUND

L'élément demandé est introuvable.

DDERR_NOTINITIALIZED

Une tentative d’appel d’une méthode d’interface d’un objet DirectDraw créé par CoCreateInstance a été effectuée avant l’initialisation de l’objet.

DDERR_NOTLOADED

La surface est une surface optimisée, mais elle n’a pas encore été allouée de mémoire.

DDERR_NOTLOCKED

Une tentative de déverrouillage d’une surface qui n’était pas verrouillée a été effectuée.

DDERR_NOTPAGELOCKED

Une tentative de déverrouillage de page d’une surface sans verrous de page en suspens a été effectuée.

DDERR_NOTPALETTIZED

La surface utilisée n’est pas une surface basée sur une palette.

DDERR_NOVSYNCHW

Il n’existe aucune prise en charge matérielle pour les opérations verticales synchronisées vides.

DDERR_NOZBUFFERHW

L’opération permettant de créer une mémoire tampon z dans la mémoire d’affichage ou d’effectuer un transfert de bloc de bits (bitblt) à l’aide d’un z-buffer ne peut pas être effectuée, car il n’existe aucune prise en charge matérielle pour les z-buffers.

DDERR_NOZOVERLAYHW

Les surfaces de superposition ne peuvent pas être en couche z, en fonction de l’ordre de plan, car le matériel ne prend pas en charge l’ordre de plan des superpositions.

DDERR_OUTOFCAPS

Le matériel nécessaire à l’opération demandée a déjà été alloué.

DDERR_OUTOFMEMORY

DirectDraw ne dispose pas de suffisamment de mémoire pour effectuer l’opération.

DDERR_OUTOFVIDEOMEMORY

DirectDraw ne dispose pas de suffisamment de mémoire d’affichage pour effectuer l’opération.

DDERR_OVERLAPPINGRECTS

Les rectangles source et de destination se trouvent sur la même surface et se chevauchent.

DDERR_OVERLAYCANTCLIP

Le matériel ne prend pas en charge les superpositions clippées.

DDERR_OVERLAYCOLORKEYONLYONEACTIVE

Une tentative a été effectuée pour avoir plusieurs clés de couleur actives sur une superposition.

DDERR_OVERLAYNOTVISIBLE

La méthode IDirectDrawSurface7::GetOverlayPosition a été appelée sur une superposition masquée.

DDERR_PALETTEBUSY

L’accès à cette palette est refusé, car la palette est verrouillée par un autre thread.

DDERR_PRIMARYSURFACEALREADYEXISTS

Ce processus a déjà créé une surface primaire.

DDERR_REGIONTOOSMALL

La région passée à la méthode IDirectDrawClipper::GetClipList est trop petite.

DDERR_SURFACEALREADYATTACHED

Une tentative a été effectuée pour attacher une surface à une autre surface à laquelle elle est déjà attachée.

DDERR_SURFACEALREADYDEPENDENT

Une tentative a été effectuée pour faire d’une surface une dépendance d’une autre surface dont elle dépend déjà.

DDERR_SURFACEBUSY

L’accès à la surface est refusé, car la surface est verrouillée par un autre thread.

DDERR_SURFACEISOBSCURED

L’accès à la surface est refusé, car la surface est masquée.

DDERR_SURFACELOST

L’accès à la surface est refusé, car la mémoire de la surface a disparu. Appelez la méthode IDirectDrawSurface7::Restore sur cette surface pour restaurer la mémoire qui lui est associée.

DDERR_SURFACENOTATTACHED

La surface demandée n’est pas attachée.

DDERR_TESTFINISHED

Nouveauté de DirectX 7.0. Lorsqu’elle est retournée par la méthode IDirectDraw7::StartModeTest , cette valeur signifie qu’aucun test n’a pu être lancé, car toutes les résolutions choisies pour le test ont déjà des informations sur la fréquence d’actualisation dans le Registre. Lorsqu’elle est retournée par IDirectDraw7::EvaluateMode, la valeur signifie que DirectDraw a terminé un test de fréquence d’actualisation.

DDERR_TOOBIGHEIGHT

La hauteur demandée par DirectDraw est trop grande.

DDERR_TOOBIGSIZE

La taille demandée par DirectDraw est trop grande. Toutefois, la hauteur et la largeur individuelles sont des tailles valides.

DDERR_TOOBIGWIDTH

La largeur demandée par DirectDraw est trop grande.

DDERR_UNSUPPORTED

L'opération n'est pas prise en charge.

DDERR_UNSUPPORTEDFORMAT

Le format de pixel demandé n’est pas pris en charge par DirectDraw.

DDERR_UNSUPPORTEDMASK

Le masque de bits au format de pixel demandé n’est pas pris en charge par DirectDraw.

DDERR_UNSUPPORTEDMODE

L’affichage est actuellement en mode non pris en charge.

DDERR_VERTICALBLANKINPROGRESS

Un vide vertical est en cours.

DDERR_VIDEONOTACTIVE

Le port vidéo n’est pas actif.

DDERR_WASSTILLDRAWING

L’opération bitblt précédente qui transfère des informations vers ou depuis cette surface est incomplète.

DDERR_WRONGMODE

Cette surface ne peut pas être restaurée, car elle a été créée dans un mode différent.

DDERR_XALIGN

Le rectangle fourni n’était pas aligné horizontalement sur une limite requise.

Spécifications

Condition requise	Valeur
En-tête	Ddraw.h