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. |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de