Valores devueltos para DirectDraw

En las tablas siguientes se enumeran los valores que pueden devolver las funciones proporcionadas por el controlador DirectDraw. Los valores DDHAL_DRIVER_Xxx se devuelven realmente en el valor devuelto DWORD. Los códigos de error DD_OK y DDERR_Xxx se devuelven en el miembro ddRVal de la estructura a la que apunta el parámetro de la función determinada.

Para obtener códigos de error específicos que cada función puede devolver, consulte las descripciones de la función en la sección de referencia. Consulte los archivos de encabezado de DirectDraw ddraw.h y dxmini.h para obtener una lista completa de códigos de error y valores devueltos. Tenga en cuenta que los códigos de error se representan mediante valores negativos y no se pueden combinar.

Una función de un controlador de DirectDraw debe devolver uno de los dos códigos de retorno: DDHAL_DRIVER_HANDLED o DDHAL_DRIVER_NOTHANDLED. Si el controlador devuelve DDHAL_DRIVER_HANDLED, también debe devolver DD_OK o uno de los códigos de error enumerados en ddraw.h. Una función de un controlador de DirectDraw puede devolver los códigos de la tabla siguiente. Estos códigos se definen en ddraw.h.

Código de retorno	Significado
DD_OK	La solicitud se completó correctamente.
DDHAL_DRIVER_HANDLED	El controlador ha realizado la operación y ha devuelto un código de retorno válido para esa operación en el miembro ddrval de la estructura pasada a la devolución de llamada del controlador. Si este código es DD_OK, DirectDraw o Direct3D continúa con la función . De lo contrario, DirectDraw o Direct3D devuelven el código de error proporcionado por el controlador y anulan la función.
DDHAL_DRIVER_NOCKEYHW	El controlador de pantalla no pudo controlar la llamada porque se quedó sin recursos de hardware de clave de color.
DDHAL_DRIVER_NOTHANDLED	El controlador no tiene ningún comentario sobre la operación solicitada. Si se requiere que el controlador haya implementado una devolución de llamada determinada, DirectDraw o Direct3D notifican una condición de error. De lo contrario, DirectDraw o Direct3D controla la operación como si no se hubiera definido la devolución de llamada del controlador mediante la ejecución de la implementación independiente del dispositivo de DirectDraw o Direct3D. DirectDraw y Direct3D normalmente omiten cualquier valor devuelto en el miembro ddrval de la estructura de parámetros de esa devolución de llamada.
DDERR_GENERIC	Hay una condición de error no definida.
DDERR_OUTOFCAPS	Ya se ha asignado el hardware necesario para la operación solicitada.
DDERR_UNSUPPORTED	La operación no es compatible.

Una función DxApi que se implementa en un controlador de minipuerto de vídeo devuelve uno de los códigos de la tabla siguiente. Estos códigos se definen en dxmini.h.

Código de retorno	Significado
DX_OK	La solicitud se completó correctamente.
DXERR_GENERIC	Hay una condición de error no definida.
DXERR_OUTOFCAPS	Ya se ha asignado el hardware necesario para la operación solicitada.
DXERR_UNSUPPORTED	La operación no es compatible.