CreateICA function (wingdi.h)

The CreateIC function creates an information context for the specified device. The information context provides a fast way to get information about the device without creating a device context (DC). However, GDI drawing functions cannot accept a handle to an information context.

Syntax

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

Parameters

[in] pszDriver

A pointer to a null-terminated character string that specifies the name of the device driver (for example, Epson).

[in] pszDevice

A pointer to a null-terminated character string that specifies the name of the specific output device being used, as shown by the Print Manager (for example, Epson FX-80). It is not the printer model name. The lpszDevice parameter must be used.

pszPort

This parameter is ignored and should be set to NULL. It is provided only for compatibility with 16-bit Windows.

[in] pdm

A pointer to a DEVMODE structure containing device-specific initialization data for the device driver. The DocumentProperties function retrieves this structure filled in for a specified device. The lpdvmInit parameter must be NULL if the device driver is to use the default initialization (if any) specified by the user.

Return value

If the function succeeds, the return value is the handle to an information context.

If the function fails, the return value is NULL.

Remarks

When you no longer need the information DC, call the DeleteDC function.

Note

The wingdi.h header defines CreateIC as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

DEVMODE

DeleteDC

Device Context Functions

Device Contexts Overview

DocumentProperties

GetDeviceCaps