DIB_Enable

WORD DIB_Enable (LPVOID lpDevInfo, WORD wAction, LPSTR lpDestDevType,
    LPSTR lpOutputFile, LPVOID lpData)
 

Enables the DIB engine and initializes the dpCurves through dpStyleLen members of a GDIINFO structure. The minidriver must call this function when initializing the members of the GDIINFO structure. This function must be called before CreateDIBPDevice.

• Returns TRUE if successful, FALSE otherwise.

lpDevInfo

Address of a GDIINFO structure.

wAction

One of the following actions.

Value	Meaning
0x0001	Initialize the dpCurves through dpStyleLen members of the GDIINFO structure pointed to by lpDevInfo.
0x8001	Same as 0x0001. The high bit is set if an application has requested an information context.

lpDestDevType

Address of a string specifying the device name. This string only applies to device drivers that support more than one model of the same device. The parameter can be NULL if only one model is supported.

lpOutputFile

Address of a string specifying the name of the output port or file to receive output from the driver. The string must be a valid MS-DOS filename. If the lpOutputFile parameter is NULL, the output device is the system display.

lpData

Address of DEVMODE structure containing information the minidriver's Enable function uses to initialize the device. It can be NULL if no such information is needed.

The export ordinal for this function is 5.

Because the DIB engine support features in addition to those supported by the display minidriver, the DIB engine may set bits in the GDIINFO structure other than were set by the minidriver. In such cases, the display minidriver must leave those bits set.