DRV_CONFIGURE

3.1

The DRV_CONFIGURE message is sent to inform an installable driver that it should display its private configuration dialog box.

Parameters

dwDriverIdentifier

Specifies a unique 32-bit value that identifies the installable driver.

hDriver

Identifies an instance of the installable driver.

lParam1

Specifies the handle of the parent window for the configuration dialog box. This handle is in the parameter's low-order word.

lParam2

Points to an optional DRVCONFIGINFO structure. An installable driver should verify that this pointer is valid before using it.

This structure has the following form:

typedef struct tagDRVCONFIGINFO {
    DWORD   dwDCISize;
    LPCSTR  lpszDCISectionName;
    LPCSTR  lpszDCIAliasName;
} DRVCONFIGINFO;

Return Value

An installable driver returns nonzero if it processes this message. Otherwise, it returns zero.

Comments

An installable driver that supports the DRV_CONFIGURE message must provide its own dialog box template and dialog box procedure. It must also record the user's configuration requests in an appropriate file. (This may be the SYSTEM.INI file or some other file used by the driver for this purpose.)

See Also

DRV_QUERYCONFIGURE