Función NtGdiDdSetColorKey
[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 |
|---|---|
|
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. |
|
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 |
|
Consulte también