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)

另请参阅

DrvGetModes

DrvSetPalette