Поделиться через


Функция DrvAssertMode (winddi.h)

Функция DrvAssertMode устанавливает режим указанного физического устройства в режим, указанный при инициализации PDEV, или режим по умолчанию для оборудования.

Синтаксис

BOOL DrvAssertMode(
  [in] DHPDEV dhpdev,
  [in] BOOL   bEnable
);

Параметры

[in] dhpdev

Дескриптор PDEV, описывающий аппаратный режим, который следует задать, если параметр bEnable имеет значение TRUE.

[in] bEnable

Указывает режим, в котором должно быть установлено оборудование. Если этот параметр имеет значение TRUE, драйвер должен установить для оборудования исходный режим, заданный инициализированным PDEV. В противном случае, если этот параметр имеет значение FALSE, драйвер должен установить для оборудования режим по умолчанию, чтобы драйвер видео минипорта смог взять на себя управление.

Возвращаемое значение

DrvAssertMode возвращает значение TRUE , если он успешно изменил режим отображения; Если не удалось изменить режим отображения, возвращается значение FALSE . Драйвер может возвращать значение FALSE из вызова DrvAssertMode с параметром bEnable , равным FALSE. Драйвер должен возвращать значение TRUE из вызова DrvAssertMode с параметром bEnable, равнымTRUE; то есть драйвер не может включить ранее включенный режим.

Комментарии

GDI вызывает DrvAssertMode , когда требуется переключаться между несколькими рабочими столами на одной поверхности дисплея. Чтобы переключиться с одного PDEV на другой, GDI вызывает DrvAssertMode с параметром bEnable, равнымFALSE для одного PDEV и TRUE для другого. Чтобы отменить изменения к исходному PDEV, drvAssertMode вызывается с параметром bEnable со значением FALSE, за которым следует еще один вызов DrvAssertMode, при этом параметру bEnable присваивается значение TRUE, а dhpdev — исходное значение PDEV.

Если физическое устройство управляется палитрой, GDI вызовет DrvSetPalette , чтобы сбросить палитру устройства. Драйверу не нужно отслеживать текущее состояние указателя, так как диспетчер окон выбирает правильную фигуру указателя и перемещает его в текущее положение. Диспетчер консоли обеспечивает правильную перерисовку рабочих столов.

DrvAssertMode необходимо реализовать в драйверах отображения.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть winddi.h (включая Winddi.h)

См. также раздел

DrvGetModes

DrvSetPalette