DspQueryDriverInfo

DspQueryDriverInfo allows the caller to query driver information about any PM display driver that has been registered with the operating system (by using DspSetDriverInfo).

Syntax

DspQueryDriverInfo(pDSPInfo, flOptions);

Parameters

pDSPInfo (PDSPINFO) - input

Pointer to a data structure.

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.

Return Code

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

Remarks

Display drivers can be identified explicitly by name. If the DSP_QUERY_DEFAULT_DRIVER flag is set, the information for the default driver is returned. If the DSP_QUERY_CURRENT_DRIVER flag is set, the information for the current driver is returned. Otherwise, the information on the given driver is returned.