CDC::CreateDC

virtual BOOL CreateDC( LPCTSTR lpszDriverName, LPCTSTR lpszDeviceName, LPCTSTR lpszOutput, const void* lpInitData );

Return Value

Nonzero if the function is successful; otherwise 0.

Parameters

lpszDriverName

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

lpszDeviceName

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

lpszOutput

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

lpInitData

Points to a DEVMODE structure containing device-specific initialization data for the device driver. The Windows DocumentProperties function retrieves this structure filled in for a given device. 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.

Remarks

Creates a device context for the specified device.

The PRINT.H header file is required if the DEVMODE structure is used.

Device names follow these 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.

CDC Overview | Class Members | Hierarchy Chart