DevOpenDC - Parameters

hab (HAB) - input

Anchor-block handle.

lType (LONG) - input

Type of device context:

OD_QUEUED

A device, such as a printer or plotter, for which output is to be queued.

Certain restrictions apply for this device type;

OD_DIRECT
A device, such as a printer or plotter, for which output is not to be queued.
OD_INFO
A device, such as a printer or plotter, but the device context is used only to retrieve information (for example, font metrics). Drawing can be performed to a presentation space associated with such a device context, but no output medium is updated.
OD_METAFILE
The device context is used to write a metafile. The presentation page defines the area of interest within the picture in the metafile. See OD_METAFILE_NOQUERY.

Certain restrictions apply for this device type;

OD_METAFILE_NOQUERY
The device context is used to write a metafile.

Functionally, this device type is the same as OD_METAFILE, except that querying of attributes is not allowed with a presentation space while it is associated with an OD_METAFILE_NOQUERY device context. If querying of attributes is not required, OD_METAFILE_NOQUERY should be used in preference to OD_METAFILE, since it gives improved performance.

Certain restrictions apply for this device type;

OD_MEMORY
A device context that is used to contain a bit map. The hdcComp parameter identifies a device with which the memory device context is to be compatible.

pszToken (PSZ) - input

Device-information token.

This identifies the device information, held in the initialization file. This information is the same as that which may be pointed to by pdopData; any information that is obtained from pdopData overrides the information obtained by using this parameter.

If pszToken is specified as "*", no device information is taken from the initialization file.

OS/2 behaves as if "*" is specified, but it allows any string.

lCount (LONG) - input

Number of items.

This is the number of items present in the pdopData parameter. This can be less than the full list if omitted items are irrelevant, or are supplied from pszToken or elsewhere.

pdopData (PDEVOPENDATA) - input

Open-device-context data area.

hdcComp (HDC) - input

Compatible-device-context handle.

When lType is OD_MEMORY, this parameter is a handle to a device context compatible with bit maps that are to be used with this device context.

If hdcComp is NULLHANDLE, compatibility with the screen is assumed.

hdc (HDC) - returns

Device-context handle:

DEV_ERROR

Error
<>0
Device-context handle.

---

[Back: DevOpenDC Return Value - hdc]
[Next: DevOpenDC - Remarks]