Códigos de retorno de DirectDraw

Los errores se representan mediante valores negativos y no se pueden combinar. En esta tabla se enumeran los valores que pueden devolver todos los métodos de las interfaces de DirectDraw y las funciones de DirectDraw. Para obtener una lista de los códigos de error que puede devolver cada método o función, consulte la descripción del método o de la función.

DD_OK

La solicitud se completó correctamente.

DDERR_ALREADYINITIALIZED

El objeto ya se ha inicializado.

DDERR_BLTFASTCANTCLIP

Un objeto DirectDrawClipper se adjunta a una superficie de origen que ha pasado a una llamada al método IDirectDrawSurface7::BltFast .

DDERR_CANNOTATTACHSURFACE

Una superficie no se puede conectar a otra superficie solicitada.

DDERR_CANNOTDETACHSURFACE

Una superficie no se puede desasociar de otra superficie solicitada.

DDERR_CANTCREATEDC

Windows no puede crear más contextos de dispositivo (CONTROLADORES) o un controlador de dominio ha solicitado una superficie indizada por paleta cuando la superficie no tenía paleta y el modo de presentación no estaba indizado por paleta (en este caso, DirectDraw no puede seleccionar una paleta adecuada en el controlador de dominio).

DDERR_CANTDUPLICATE

Las superficies principales y 3D, o superficies que se crean implícitamente, no se pueden duplicar.

DDERR_CANTLOCKSURFACE

Se rechaza el acceso a esta superficie porque se intentó bloquear la superficie principal sin compatibilidad con la interfaz de control de pantalla (DCI).

DDERR_CANTPAGELOCK

Error al intentar bloquear páginas una superficie. El bloqueo de página no funciona en una superficie de memoria de visualización ni en una superficie primaria emulada.

DDERR_CANTPAGEUNLOCK

Error al intentar desbloquear una superficie en páginas. El desbloqueo de páginas no funciona en una superficie de memoria de pantalla ni en una superficie primaria emulada.

DDERR_CLIPPERISUSINGHWND

Se intentó establecer una lista de clips para un objeto DirectDrawClipper que ya está supervisando un identificador de ventana.

DDERR_COLORKEYNOTSET

No se especifica ninguna clave de color de origen para esta operación.

DDERR_CURRENTLYNOTAVAIL

Actualmente no hay soporte técnico disponible.

DDERR_DDSCAPSCOMPLEXREQUIRED

Novedades de DirectX 7.0. La superficie requiere la marca DDSCAPS_COMPLEX.

DDERR_DCALREADYCREATED

Ya se ha devuelto un contexto de dispositivo (DC) para esta superficie. Solo se puede recuperar un controlador de dominio para cada superficie.

>DDERR_DEVICEDOESNTOWNSURFACE

Otro dispositivo DirectDraw no puede usar directamente las superficies creadas por un dispositivo DirectDraw.

>DDERR_DIRECTDRAWALREADYCREATED

Ya se ha creado un objeto DirectDraw que representa este controlador para este proceso.

DDERR_EXCEPTION

Se encontró una excepción al realizar la operación solicitada.

DDERR_EXCLUSIVEMODEALREADYSET

Se intentó establecer el nivel cooperativo cuando ya estaba establecido en exclusivo.

DDERR_EXPIRED

Los datos han expirado y, por tanto, ya no son válidos.

DDERR_GENERIC

Hay una condición de error no definida.

DDERR_HEIGHTALIGN

El alto del rectángulo proporcionado no es un múltiplo de la alineación necesaria.

DDERR_HWNDALREADYSET

Ya se ha establecido el identificador de ventana de nivel cooperativo de DirectDraw. No se puede restablecer mientras el proceso tiene superficies o paletas creadas.

DDERR_HWNDSUBCLASSED

DirectDraw no puede restaurar el estado porque el identificador de ventana de nivel cooperativo de DirectDraw se ha subclasizado.

DDERR_IMPLICITLYCREATED

No se puede restaurar la superficie porque es una superficie creada implícitamente.

DDERR_INCOMPATIBLEPRIMARY

La solicitud de creación de superficie principal no coincide con la superficie principal existente.

DDERR_INVALIDCAPS

Uno o varios de los bits de funcionalidad pasados a la función de devolución de llamada son incorrectos.

DDERR_INVALIDCLIPLIST

DirectDraw no admite la lista de clips proporcionada.

DDERR_INVALIDDIRECTDRAWGUID

El identificador único global (GUID) pasado a la función DirectDrawCreate no es un identificador de controlador de DirectDraw válido.

DDERR_INVALIDMODE

DirectDraw no admite el modo solicitado.

DDERR_INVALIDOBJECT

DirectDraw recibió un puntero que era un objeto DirectDraw no válido.

DDERR_INVALIDPARAMS

Uno o varios de los parámetros pasados al método son incorrectos.

DDERR_INVALIDPIXELFORMAT

El formato de píxel no era válido según lo especificado.

DDERR_INVALIDPOSITION

La posición de la superposición en el destino ya no es válida.

DDERR_INVALIDRECT

El rectángulo proporcionado no era válido.

DDERR_INVALIDSTREAM

La secuencia especificada contiene datos no válidos.

DDERR_INVALIDSURFACETYPE

La superficie era del tipo incorrecto.

DDERR_LOCKEDSURFACES

Una o varias superficies están bloqueadas, lo que provoca el error de la operación solicitada.

DDERR_MOREDATA

Hay más datos disponibles de los que puede contener el tamaño de búfer especificado.

DDERR_NEWMODE

Novedades de DirectX 7.0. Cuando se llama a IDirectDraw7::StartModeTest con la marca DDSMT_ISTESTREQUIRED, puede devolver este valor para indicar que algunas o todas las resoluciones pueden y deben probarse. IDirectDraw7::EvaluateMode devuelve este valor para indicar que la prueba ha cambiado a un nuevo modo de presentación.

DDERR_NO3D

No hay hardware o emulación 3D presente.

DDERR_NOALPHAHW

No hay hardware de aceleración alfa presente o disponible, lo que provoca el error de la operación solicitada.

DDERR_NOBLTHW

No hay ningún bloque de bits que transfiera hardware.

DDERR_NOCLIPLIST

No hay ninguna lista de clips disponible.

DDERR_NOCLIPPERATTACHED

No hay ningún objeto DirectDrawClipper adjunto al objeto de superficie.

DDERR_NOCOLORCONVHW

No hay hardware de conversión de color presente o disponible.

DDERR_NOCOLORKEY

La superficie no tiene actualmente una clave de color.

DDERR_NOCOLORKEYHW

No hay compatibilidad de hardware con la clave de color de destino.

DDERR_NOCOOPERATIVELEVELSET

Se llamó a una función create sin el método IDirectDraw7::SetCooperativeLevel .

DDERR_NODC

No se ha creado ningún contexto de dispositivo (DC) para esta superficie.

DDERR_NODDROPSHW

No hay hardware de operación ráster (ROP) de DirectDraw disponible.

DDERR_NODIRECTDRAWHW

No es posible crear objetos DirectDraw de solo hardware; el controlador no admite ningún hardware.

DDERR_NODIRECTDRAWSUPPORT

La compatibilidad con DirectDraw no es posible con el controlador de pantalla actual.

DDERR_NODRIVERSUPPORT

Novedades de DirectX 7.0. Las pruebas no pueden continuar porque el controlador del adaptador de pantalla no enumera las tasas de actualización.

DDERR_NOEMULATION

La emulación de software no está disponible.

DDERR_NOEXCLUSIVEMODE

La operación requiere que la aplicación tenga el modo exclusivo, pero la aplicación no tiene modo exclusivo.

DDERR_NOFLIPHW

No se admite el volteo de superficies visibles.

DDERR_NOFOCUSWINDOW

Se intentó crear o establecer una ventana de dispositivo sin establecer primero la ventana de enfoque.

DDERR_NOGDI

No hay ningún GDI presente.

DDERR_NOHWND

La notificación de Clipper requiere un identificador de ventana o no se ha establecido previamente ningún identificador de ventana como identificador de ventana de nivel cooperativo.

DDERR_NOMIPMAPHW

No hay hardware de asignación de texturas compatible con mipmap presente o disponible.

DDERR_NOMIRRORHW

No hay hardware de creación de reflejo presente o disponible.

DDERR_NOMONITORINFORMATION

Novedades de DirectX 7.0. Las pruebas no pueden continuar porque el monitor no tiene datos EDID asociados.

DDERR_NONONLOCALVIDMEM

Se intentó asignar memoria de vídeo no local desde un dispositivo que no admite la memoria de vídeo no local.

DDERR_NOOPTIMIZEHW

El dispositivo no admite superficies optimizadas.

DDERR_NOOVERLAYDEST

Se llama al método IDirectDrawSurface7::GetOverlayPosition en una superposición en la que no se ha llamado al método IDirectDrawSurface7::UpdateOverlay para establecer como destino.

DDERR_NOOVERLAYHW

No hay hardware de superposición presente o disponible.

DDERR_NOPALETTEATTACHED

No hay ningún objeto de paleta adjunto a esta superficie.

DDERR_NOPALETTEHW

No hay compatibilidad de hardware con paletas de 16 o 256 colores.

DDERR_NORASTEROPHW

No hay ningún hardware de operación ráster adecuado presente o disponible.

DDERR_NOROTATIONHW

No hay hardware de rotación presente o disponible.

DDERR_NOSTEREOHARDWARE

No hay hardware estéreo presente o disponible.

DDERR_NOSTRETCHHW

No hay soporte de hardware para estirar.

DDERR_NOSURFACELEFT

No hay hardware presente que admita superficies estéreo.

DDERR_NOT4BITCOLOR

El objeto DirectDrawSurface no usa una paleta de colores de 4 bits y la operación solicitada requiere una paleta de colores de 4 bits.

DDERR_NOT4BITCOLORINDEX

El objeto DirectDrawSurface no usa una paleta de índices de colores de 4 bits y la operación solicitada requiere una paleta de índices de colores de 4 bits.

DDERR_NOT8BITCOLOR

El objeto DirectDrawSurface no usa una paleta de colores de 8 bits y la operación solicitada requiere una paleta de colores de 8 bits.

DDERR_NOTAOVERLAYSURFACE

Se llama a un componente de superposición para una superficie no superpuesta.

DDERR_NOTEXTUREHW

No se puede realizar la operación porque no hay hardware de asignación de texturas presente o disponible.

DDERR_NOTFLIPPABLE

Se intentó voltear una superficie que no se puede voltear.

DDERR_NOTFOUND

No se encontró el elemento solicitado.

DDERR_NOTINITIALIZED

Se intentó llamar a un método de interfaz de un objeto DirectDraw creado por CoCreateInstance antes de que se inicializara el objeto.

DDERR_NOTLOADED

La superficie es una superficie optimizada, pero aún no se ha asignado ninguna memoria.

DDERR_NOTLOCKED

Se intentó desbloquear una superficie que no estaba bloqueada.

DDERR_NOTPAGELOCKED

Se intentó desbloquear una superficie sin bloqueos de página pendientes.

DDERR_NOTPALETTIZED

La superficie que se usa no es una superficie basada en paletas.

DDERR_NOVSYNCHW

No hay compatibilidad de hardware con operaciones sincronizadas verticales en blanco.

DDERR_NOZBUFFERHW

La operación para crear un búfer z en la memoria de visualización o para realizar una transferencia de bloques de bits (bitblt), mediante un búfer z no se puede llevar a cabo porque no hay compatibilidad de hardware con búferes z.

DDERR_NOZOVERLAYHW

Las superficies superpuestas no se pueden superponer, en función del orden z porque el hardware no admite el orden z de las superposiciones.

DDERR_OUTOFCAPS

Ya se ha asignado el hardware necesario para la operación solicitada.

DDERR_OUTOFMEMORY

DirectDraw no tiene suficiente memoria para realizar la operación.

DDERR_OUTOFVIDEOMEMORY

DirectDraw no tiene suficiente memoria para mostrar para realizar la operación.

DDERR_OVERLAPPINGRECTS

Los rectángulos de origen y destino se encuentran en la misma superficie y se superponen entre sí.

DDERR_OVERLAYCANTCLIP

El hardware no admite superposiciones recortadas.

DDERR_OVERLAYCOLORKEYONLYONEACTIVE

Se intentó activar más de una tecla de color en una superposición.

DDERR_OVERLAYNOTVISIBLE

Se llamó al método IDirectDrawSurface7::GetOverlayPosition en una superposición oculta.

DDERR_PALETTEBUSY

Se rechaza el acceso a esta paleta porque otro subproceso bloquea la paleta.

DDERR_PRIMARYSURFACEALREADYEXISTS

Este proceso ya ha creado una superficie principal.

DDERR_REGIONTOOSMALL

La región pasada al método IDirectDrawClipper::GetClipList es demasiado pequeña.

DDERR_SURFACEALREADYATTACHED

Se intentó conectar una superficie a otra superficie a la que ya está conectada.

DDERR_SURFACEALREADYDEPENDENT

Se intentó hacer que una superficie sea una dependencia de otra superficie en la que ya depende.

DDERR_SURFACEBUSY

Se rechaza el acceso a la superficie porque otro subproceso bloquea la superficie.

DDERR_SURFACEISOBSCURED

Se rechaza el acceso a la superficie porque la superficie está oculta.

DDERR_SURFACELOST

Se rechaza el acceso a la superficie porque la memoria de la superficie ha desaparecido. Llame al método IDirectDrawSurface7::Restore en esta superficie para restaurar la memoria asociada a ella.

DDERR_SURFACENOTATTACHED

La superficie solicitada no está conectada.

DDERR_TESTFINISHED

Novedades de DirectX 7.0. Cuando devuelve el método IDirectDraw7::StartModeTest , este valor significa que no se pudo iniciar ninguna prueba porque todas las resoluciones elegidas para las pruebas ya tienen información de frecuencia de actualización en el registro. Cuando devuelve IDirectDraw7::EvaluateMode, el valor significa que DirectDraw ha completado una prueba de frecuencia de actualización.

DDERR_TOOBIGHEIGHT

El alto solicitado por DirectDraw es demasiado grande.

DDERR_TOOBIGSIZE

El tamaño solicitado por DirectDraw es demasiado grande. Sin embargo, el alto y el ancho individuales son tamaños válidos.

DDERR_TOOBIGWIDTH

El ancho solicitado por DirectDraw es demasiado grande.

DDERR_UNSUPPORTED

La operación no es compatible.

DDERR_UNSUPPORTEDFORMAT

DirectDraw no admite el formato de píxel solicitado.

DDERR_UNSUPPORTEDMASK

DirectDraw no admite la máscara de bits en el formato de píxel solicitado.

DDERR_UNSUPPORTEDMODE

La pantalla está actualmente en modo no admitido.

DDERR_VERTICALBLANKINPROGRESS

Un espacio en blanco vertical está en curso.

DDERR_VIDEONOTACTIVE

El puerto de vídeo no está activo.

DDERR_WASSTILLDRAWING

La operación bitblt anterior que transfiere información a o desde esta superficie está incompleta.

DDERR_WRONGMODE

Esta superficie no se puede restaurar porque se creó en un modo diferente.

DDERR_XALIGN

El rectángulo proporcionado no estaba alineado horizontalmente en un límite necesario.

Requisitos

Requisito	Value
Encabezado	Ddraw.h