## Pen for OS/2 Device Driver Reference

[prev][next][parent][TOC]

### xxxxx.WPO Control File

This control file defines the objects in the new Pen for OS/2 folder. The following figure is a sample entry used to create a Pen for OS/2 device object. The first entry in this file represents the number of WPObject entries to follow. The second entry is used to show the percent completed on the Updating system files progress indicator. The percent complete value from this file plus the percent values from .WPO and .CCH must equal 100 percent.

    --------------------------------------------------------------------------

    1
    80
    WPObject =
    (
     WPClassName   = "WPFolder"
     WPTitle       = "Devices"
     WPSetupString = "OBJECTID=<DEVICES_FOLDER>"
     WPLocation    = "<PPM_FOLDER>"
     WPFlags       = OL
    )
    WPObject =
    (
     WPClassName   = "PenLocatorPen"
     WPTitle       = "Pen"
     WPSetupString = "OBJECTID=<PENDD_STYLUS>;CALPROG=$(DEST)CAL.EXE;
                      CALPARMS=TRUE;
                      PEN_DRIVER=Digitizer Mod 3;
                      PEN_DEVICE=Pen"
     WPLocation    = "<DEVICES_FOLDER>"
     WPFlags       = 1L
    )

    --------------------------------------------------------------------------

Where:

$(DEST) A macro that is replaced by the full path that was specified as the destination path during device driver installation.

Pen The sample entry identifies a new object as a device object titled "Pen ". It will be known by the OS/2 operating system as PENDD_STYLUS and reside in the Devices folder.

WPFLags Specifies an action on PENDD_STYLUS as follows:

0 Indicates the creation should fail if PENDD_STYLUS already exists.
1 Indicates the folder should replace PENDD_STYLUS if it already exists.
2 Specifies that this folder should update the PENDD_STYLUS if it already exists.

CALPROG Specifies the name of the calibration program. If your calibration program does not need the PEN_DRIVER and PEN_DEVICE parameters passed to it as input parameters, do not use this keyword. CALPARMS=TRUE is used to tell the object to pass the PEN_DRIVER and PEN_DEVICE names as input parameters when starting CAL.EXE. The sample program, CAL.EXE, needs these two parameters to be passed in when starting. For more information, see Calibration Program.

PEN_DRIVER Refers to the string specified by the device driver in the Common Capabilities Packet defined as ccap_device_name for logical device unit 0.

PEN_DEVICE Refers to the string specified by the device driver in the Common Capabilities Packet defined as ccap_device_name for logical device units other than zero.