Función DdGetDC (ddrawgdi.h)
[Esta función está sujeta a cambios con cada revisión del sistema operativo. En su lugar, use 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.
Contenedor para la función NtGdiDdGetDC y devuelve un contexto de dispositivo de interfaz de dispositivo gráfico (GDI) de Windows (DC) que representa la superficie de Microsoft DirectDraw indicada.
GdiEntry7 se define como alias para esta función.
Sintaxis
HDC DdGetDC(
LPDDRAWI_DDRAWSURFACE_LCL pSurfaceLocal,
LPPALETTEENTRY pColorTable
);
Parámetros
pSurfaceLocal
Puntero a la superficie de DirectDraw para la que se solicita un controlador de dominio.
pColorTable
Puntero opcional a una matriz de entrada de 256 estructuras PALETTEENTRY . Si la tabla de colores es nula y el modo de superficie y presentación son de 8 bits por píxel, el controlador de dominio comparte la tabla de colores del dispositivo.
Valor devuelto
Si se ejecuta correctamente, esta función devuelve un HDC válido; de lo contrario, devuelve NULL.
Comentarios
Si tanto la superficie como el modo de visualización actual se paletizan en 8 bits por píxel, el controlador de dominio puede tener la propiedad especial compartida por la tabla de colores del dispositivo de visualización. Se recomienda que las aplicaciones llamen a IDirectDrawSurface7::GetDC en su lugar, lo que proporciona la misma funcionalidad de una manera independiente del sistema operativo.
El CONTROLADOR de dominio devuelto debe liberarse mediante una llamada a NtGdiDdReleaseDC o GdiEntry8.
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] |
| Plataforma de destino | Windows |
| Encabezado | ddrawgdi.h |