CDC::CreateIC

Syntax

BOOL CreateIC( const char FAR* lpDriverName, const char FAR* lpDeviceName, const char FAR* lpOutput, LPSTR lpInitData );

Parameters

lpDriverName

Points to a null-terminated string that specifies the MS-DOS filename (without extension) of the device driver (for example, EPSON). You can pass a CString object for this parameter.

lpDeviceName

Points to a null-terminated string that specifies the name of the specific device to be supported (for example, EPSON FX-80). The lpDeviceName parameter is used if the module supports more than one device. You can pass a CString object for this parameter.

lpOutput

Points to a null-terminated string that specifies the MS-DOS file or device name for the physical output medium (file or port). You can pass a CString object for this parameter.

lpInitData

Points to device-specific initialization data for the device driver. The lpInitData parameter must be NULL if the device driver is to use the default initialization (if any) specified by the user through the Control Panel. See CreateDC for the data format for device-specific initialization.

Remarks

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.

MS-DOS device names follow MS-DOS conventions; an ending colon (:) is recommended, but optional. Windows strips the terminating colon so that a device name ending with a colon is mapped to the same port as the same name without a colon. The driver and port names must not contain leading or trailing spaces. GDI output functions cannot be used with information contexts.

Return Value

TRUE if successful; otherwise FALSE.

See Also

CDC::CreateDC, ::CreateIC