Función NtGdiDdSetColorKey

Artículo
06/12/2023

[Esta función está sujeta a cambios con cada revisión del sistema operativo. En su lugar, use Microsoft DirectDraw y Microsoft Direct3DAPIs; estas API aíslan las aplicaciones de estos cambios en el sistema operativo y ocultan muchas otras dificultades implicadas en la interacción directa con los controladores de pantalla.

Establece el valor de clave de color para la superficie especificada.

Sintaxis

DWORD APIENTRY NtGdiDdSetColorKey(
  _In_    HANDLE              hSurface,
  _Inout_ PDD_SETCOLORKEYDATA puSetColorKeyData
);

Parámetros

hSurface [in]: Puntero a la estructura DD_SURFACE_LOCAL que describe la superficie con la que se va a asociar la clave de color.
puSetColorKeyData [in, out]: Puntero a una estructura de DD_SETCOLORKEYDATA que contiene la información necesaria para establecer la clave de color de la superficie especificada.

Valor devuelto

NtGdiDdSetColorKey devuelve uno de los siguientes códigos de devolución de llamada.

Código devuelto	Descripción
DDHAL_DRIVER_HANDLED	El controlador ha realizado la operación y ha devuelto un código de retorno válido para esa operación. 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 anula la función.
DDHAL_DRIVER_NOTHANDLED	El controlador no tiene ningún comentario sobre la operación solicitada. Si es necesario 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 controlan 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.

Código devuelto

Descripción

DDHAL_DRIVER_HANDLED

El controlador ha realizado la operación y ha devuelto un código de retorno válido para esa operación. 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 anula la función.

DDHAL_DRIVER_NOTHANDLED

El controlador no tiene ningún comentario sobre la operación solicitada. Si es necesario 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 controlan 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.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Ntgdi.h

Consulte también

Compatibilidad con clientes de bajo nivel de gráficos