DrvAssertMode

VOID DrvAssertMode(

IN DHPDEV dhpdev,
IN BOOL bEnable
);

DrvAssertMode sets the mode of the specified physical device to either the mode specified when the PDEV was initialized or to the default mode of the hardware.

Parameters

dhpdev

Identifies the PDEV describing the hardware mode that should be set.

bEnable

Specifies the mode to which the hardware is to be set. If this parameter is TRUE, then the hardware is set to the original mode specified by the initialized PDEV. Otherwise, the hardware is set to its default mode so the video miniport driver can assume control.

Comments

GDI calls DrvAssertMode when it is required to switch among multiple desktops on a single display surface. To switch from one PDEV to another, GDI calls DrvAssertMode with the bEnable parameter set to FALSE for one PDEV, and TRUE for the other. To revert to the original PDEV, DrvAssertMode is called with bEnable set to FALSE, followed by another call to DrvAssertMode, with bEnable set to TRUE and dhpdev set to the original PDEV.

If the physical device is palette-managed, GDI should call DrvSetPalette to reset the device's palette. The driver does not then need to keep track of the current pointer state because the Window Manager selects the correct pointer shape and moves it to the current position. The Console Manager ensures that desktops are properly redrawn.

DrvAssertMode is required for display drivers.

See Also

DrvGetModes