Códigos de retorno para devoluciones de llamada del controlador direct3D

En la tabla siguiente se enumeran los valores que puede devolver Direct3D Driver-Supplied Functions. Los valores DDHAL_DRIVER_Xxx se devuelven realmente en el valor devuelto DWORD. El valor de D3D_OK, los valores D3DHAL_Xxx y los códigos de error D3DERR_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 y la estructura en la sección de referencia. Consulte los archivos de encabezado de Direct3D d3d.h y d3dhal.h para obtener una lista completa de códigos de error y valores devueltos (también, d3d8.h y d3d9.h para las versiones 8.0 y 9.0 de DirectX). 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 Direct3D 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 D3D_OK o uno de los valores enumerados en d3d.h o d3dhal.h. Una función de un controlador direct3D puede devolver los valores de la tabla siguiente. Estos valores se definen en d3d.h y d3dhal.h.

Value	Significado
D3D_OK (definido como DD_OK)	La solicitud se completó correctamente.
D3DHAL_CONTEXT_BAD	El contexto que se pasó en no era válido.
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 D3D_OK, Direct3D continúa con la función . De lo contrario, Direct3D devuelve el código de error proporcionado por el controlador y anula la función.
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, Direct3D notifica una condición de error. De lo contrario, 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 Direct3D. Direct3D normalmente omite cualquier valor devuelto en el miembro ddrval de la estructura de parámetros de esa devolución de llamada.
D3DHAL_OUTOFCONTEXTS	No quedan más contextos en este proceso.
D3DERR_UNSUPPORTEDCOLOROPERATION	No se admite la operación de color.