drvAssertMode 函数 (winddi.h)
DrvAssertMode 函数将指定物理设备的模式设置为初始化 PDEV 时指定的模式或硬件的默认模式。
语法
BOOL DrvAssertMode(
[in] DHPDEV dhpdev,
[in] BOOL bEnable
);
参数
[in] dhpdev
描述 bEnable 为 TRUE 时应设置的硬件模式的 PDEV 的句柄。
[in] bEnable
指定要设置硬件的模式。 如果此参数为 TRUE，驱动程序应将硬件设置为初始化的 PDEV 指定的原始模式。 否则，如果此参数为 FALSE，驱动程序应将硬件设置为其默认模式，以便视频微型端口驱动程序可以承担控制权。
返回值
如果 DrvAssertMode 成功更改了显示模式，则返回 TRUE ;如果无法更改显示模式，则返回 FALSE 。 允许驱动程序在 bEnable 设置为 FALSE 的情况下从 DrvAssertMode 调用返回 FALSE。 驱动程序必须从 DrvAssertMode 调用返回 TRUE，并且 bEnable 设置为 TRUE;也就是说，驱动程序无法启用以前启用的模式。
注解
当需要在单个显示图面上的多个桌面之间切换时，GDI 调用 DrvAssertMode 。 若要从一个 PDEV 切换到另一个 PDEV，GDI 调用 DrvAssertMode ，其中一个 PDEV 的 bEnable 参数设置为 FALSE ，将另一个 PDEV 设置为 TRUE 。 若要还原原始 PDEV，请调用 DrvAssertMode，并将 bEnable 设置为 FALSE，然后再次调用 DrvAssertMode，将 bEnable 设置为 TRUE，将 dhpdev 设置为原始 PDEV。
如果物理设备由调色板管理，GDI 将调用 DrvSetPalette 来重置设备的调色板。 然后，驱动程序不需要跟踪当前指针状态，因为窗口管理器选择正确的指针形状并将其移动到当前位置。 控制台管理器确保正确重绘桌面。
DrvAssertMode 必须在显示驱动程序中实现。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | winddi.h (包括 Winddi.h) |