pDSPInfo (PDSPINFO) - input

Pointer to a PDSPINFO data structure.

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_DELETE_DRIVER

Completely delete the driver information from the INI file.
DSP_OPT_PARMS_PRESENT
Optional parameters are present. The default does not use optional parameters. If this flag is not set, pszOptionalParameters is ignored and can be NULL.

DSP_SET_DEFAULT_DRIVER
Make this driver the default system display driver.
DSP_SET_INSTALL_ON_IPL
Install this driver as the current system display driver at next startup.

fSuccess (BOOL) - returns

Return codes.

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

TRUE

Success, no error
FALSE
NULL, error occurred
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:

PMERR_CURRENT_SYSTEM_DRIVER PMERR_INVALID_PARAMETER
PMERR_MEMORY_ALLOC
PMERR_MEMORY_ALLOCATION_ERR
PMERR_MEMORY_DEALLOCATION_ERR

---

[Back: DspSetDriverInfo Return Value - fSuccess]
[Next: DspSetDriverInfo - Remarks]