CreateIC

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.

HDC CreateIC(
  LPCTSTR lpszDriver,  // pointer to string specifying driver name
  LPCTSTR lpszDevice,  // pointer to string specifying device name
  LPCTSTR lpszOutput,  // pointer to string specifying port or file 
                       // name
  CONST DEVMODE *lpdvmInit 
                       // pointer to optional initialization data
);
 

Parameters

lpszDriver

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

lpszDevice

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.

lpszOutput

Pointer to a null-terminated character string that specifies the file or device name for the physical output medium (file or output port). This parameter is ignored; it is present only to keep the function prototype identical with the prototype used in the 16-bit Windows API.

lpdvmInit

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 Values

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

If the function fails, the return value is NULL.

Windows NT: To get extended error information, call GetLastError.

Remarks

An error occurs if an application calls a GDI drawing function and supplies a handle identifying an information context.

When you no longer need the information device context, call the DeleteDC function to delete it.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Device Contexts Overview, Device Context Functions, DeleteDC, DocumentProperties, DEVMODE, GetDeviceCaps