Compartir a través de


Función NtGdiDdGetDC

[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.

Crea un contexto de dispositivo (DC) para la superficie especificada.

Sintaxis

HDC APIENTRY NtGdiDdGetDC(
  _In_ HANDLE       hSurface,
  _In_ PALETTEENTRY *puColorTable
);

Parámetros

hSurface [in]

Controle una superficie de DirectDraw en modo kernel devuelta anteriormente por NtGdiDdCreateSurface o NtGdiDdCreateSurfaceObject.

puColorTable [in]

Puntero a una tabla de colores de invalidación para el controlador de dominio devuelto.

Valor devuelto

Si se ejecuta correctamente, esta función devuelve un HDC válido; de lo contrario, devuelve NULL.

Observaciones

Solo se permite un controlador de dominio por superficie en un momento dado. Las llamadas posteriores a NtGdiDdGetDC producirán un error hasta que se libere el controlador de dominio anterior.

Se recomienda que las aplicaciones llamen a IDirectDrawSurface7::GetDC , que proporciona la misma funcionalidad de una manera independiente del sistema operativo.

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

DdGetDC