DOCERR: No DDI ReEnable Docs for Windows 95 Display Minidriver

• Microsoft Win32 Device Development Kit (DDK) for Windows 95, version 4.0

SUMMARY

The Windows 95 Device Driver Kit did not include any formal documentation for the display mini-driver ReEnable function. This article supplements the DDK samples with further corrected information.

MORE INFORMATION

Pseudo Function Prototype:

BOOL ReEnable ( LPPDEVICE, LPSTR );

Parameters:

lpPDevice - Long pointer to the display drivers PDEVICE structure stored

            by the GDI.

            the GDI.

The return value is FALSE if the function failed, otherwise it is TRUE.

Comments:

ReEnable is called by GDI to change the display resolution dynamically.

If the display driver supports ReEnable, it should set C1_REINIT_ABLE in the GDIInfo structure's dpCaps1 field. The GDI won't call this DDI unless the new resolution is one that satisfied the ValidateMode call the GDI did earlier.

This function should retrieve the new resolution value from the registry (via a call to VDD's VDD_GET_DISPLAY_CONFIG service), and map it into a resolution ID (0 = 320x200, 1=640x480, 2=800x600, 3=1024x768). This resolution should be set in a global variable, which is the wResolution variable in the DDK's samples, for use elsewhere in the driver. ReEnable should then call the display drivers Enable twice to set up the GDIInfo block and the PDevice block appropriately.

REFERENCES

Windows 95 Device Driver Kit - Display Driver sample code. Windows 95 Device Driver Kit - Virtual Mini driver VxD sample code.