## Presentation Device Driver Reference for OS/2

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

### DspQueryDriverInfo - Parameters

pDSPInfo (PDSPINFO) - input Pointer to a data structure.

A pointer to a PDSPINFO data structure that contains the following values:

pszDriverName A NULL-terminated string containing the name of the driver. All IBM drivers should start with "IBM", as in IBMVGA or IBMXGA.

cchDriverName Length of the pszDriverName buffer.

pszDesc Pointer to a string describing the driver. This description is used by the program that lists the available drivers and that gives information as to which driver is loaded.

cchDesc Length of the pszDesc buffer.

pszFileName The fully qualified path name (drive, path, and file name) of the display driver DLL.

cchFileName Length of the pszFileName buffer.

pszOptionalParameters Pointer to a string of optional parameters, which might be known only to the device driver.

cchOptionalParameters Length of the pszOptionalParameters buffer.

flOptions (ULONG) - input The following flags are used to specify various options:

DSP_QUERY_OPT_PARMS Get the optional parameters. The default does not query optional parameters. If this flag is not set, pszOptionalParameters is set to NULL.

DSP_QUERY_CURRENT_DRIVER Get information about the current driver. In this case, no driver name is specified; instead, the name of the current driver is returned in pszDriverName.

DSP_QUERY_DEFAULT_DRIVER Get information about the default driver. In this case, no driver name is specified; instead, the name of the default driver is returned in pszDriverName.

fSuccess (BOOL) - returns Return codes.

On completion, this installation routine must return BOOLEAN (fSuccess).

TRUE Success
FALSE Error.

Possible Errors Detected: When an error is detected, the handling routine must call WinGetLastError to post the condition. Error codes for conditions that the handling routine is expected to check are as follows:

PMERR_INVALID_PARAMETER
PMERR_MEMORY_ALLOC
PMERR_MEMORY_ALLOCATION_ERR
PMERR_MEMORY_DEALLOCATION_ERR