Función CreateICA (wingdi.h)

Artículo
11/20/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 de 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 de 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 se produce un error en la función, el valor devuelto es NULL.

Observaciones

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

Nota

El encabezado wingdi.h define CreateIC como 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wingdi.h (incluya Windows.h)
biblioteca de	Gdi32.lib
DLL de	Gdi32.dll