The pen driver must support a minimum set of required messages, which are listed in the table below.
Message | Description |
---|---|
DRV_CLOSE | Sent by the CloseDriver Windows function to close the driver. |
DRV_CONFIGURE | Requests the driver to display its configuration dialog box. |
DRV_DISABLE | Sent when the system unloads the pen driver. |
DRV_ENABLE | Sent when the system loads the pen driver. |
DRV_FREE | Sent when the system unloads the pen driver. |
DRV_INSTALL | Informs the pen driver it should install itself on the system. The driver records the information the system needs at startup so that the next time Windows starts, the pen driver will be loaded. |
DRV_LOAD | Sent to the pen driver when it is first loaded. |
DRV_OPEN | Sent from the OpenDriver Windows function. |
DRV_QUERYCONFIGURE | Checks if the driver provides a configuration dialog box. |
DRV_REMOVE | Informs the pen driver it should uninstall itself from the system. The driver removes the information it recorded at startup and the references that the system uses to load the driver. The next time Windows starts, the pen driver will not be loaded. |
Note that a fully functioning pen driver also supports the DRV_SetEntryPoints and DRV_RemoveEntryPoints messages. However, the pen driver can be used like a mouse driver, updating the pen cursor location, without supporting these two messages.
The pen driver must handle the standard messages that are sent to any installable Windows driver. Many of these standard messages have a counterpart message with a reverse effect-DRV_CLOSE is the counterpart of DRV_OPEN, for example. The following sections briefly describe the effects of each of the standard message pairs. At the end of this section, a table lists all the DRV_ messages recognized by the pen driver and gives a summary description of each message. For more complete descriptions of each of these required standard messages, see the "Reference" section.