Función CreateICA (wingdi.h)

Artículo
03/04/2024

La función CreateIC crea un contexto de información para el dispositivo especificado. El contexto de información proporciona una manera rápida de obtener información sobre el dispositivo sin crear un contexto de dispositivo (DC). Sin embargo, las funciones de dibujo de GDI no pueden aceptar un identificador para un contexto de información.

Sintaxis

HDC CreateICA(
  [in] LPCSTR         pszDriver,
  [in] LPCSTR         pszDevice,
       LPCSTR         pszPort,
  [in] const DEVMODEA *pdm
);

Parámetros

[in] pszDriver

Puntero a una cadena de caracteres terminada en null que especifica el nombre del controlador de dispositivo (por ejemplo, Epson).

[in] pszDevice

Puntero a una cadena de caracteres terminada en null que especifica el nombre del dispositivo de salida específico que se usa, como se muestra en el Administrador de impresión (por ejemplo, Epson FX-80). No es el nombre del modelo de impresora. Se debe usar el parámetro lpszDevice .

pszPort

Este parámetro se omite y debe establecerse en NULL. Solo se proporciona por compatibilidad con Windows de 16 bits.

[in] pdm

Puntero a una estructura DEVMODE que contiene datos de inicialización específicos del dispositivo para el controlador de dispositivo. La función DocumentProperties recupera esta estructura rellenada para un dispositivo especificado. El parámetro lpdvmInit debe ser NULL si el controlador del dispositivo debe usar la inicialización predeterminada (si existe) especificada por el usuario.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el identificador de un contexto de información.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Cuando ya no necesite el controlador de dominio de información, llame a la función DeleteDC .

Nota

El encabezado wingdi.h define CreateIC como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll