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

Статья
09/27/2022
Чтение занимает 2 мин

Функция DrvGetModes выводит список режимов, поддерживаемых заданным устройством.

Синтаксис

ULONG DrvGetModes(
  [in]            HANDLE   hDriver,
                  ULONG    cjSize,
  [out, optional] DEVMODEW *pdm
);

Параметры

[in] hDriver

Дескриптор драйвера, для которого необходимо перечислить режимы. Это дескриптор, переданный в параметре hDriver функции DrvEnablePDEV .

cjSize

Указывает размер в байтах буфера, на который указывает pdm.

[out, optional] pdm

Указатель на буфер, содержащий структуры DEVMODEW для заполнения драйвера или ЗНАЧЕНИЕ NULL.

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

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

Диспетчер окон динамически загружает все драйверы отображения, связанные с драйвером минипорта (на основе раздела InstalledDisplayDrivers в реестре). Каждый драйвер дисплея вызывается для получения списка режимов, поддерживаемых этой комбинацией загруженных драйверов. Например, драйвер отображения VGA64K возвращает только режимы цвета 64K, которые были возвращены в списке режимов, полученных от драйвера мини-порта.

DrvGetModes можно вызывать до появления активного PDEV.

Ознакомьтесь с примерами Permedia , чтобы увидеть рабочую реализацию DrvGetModes.

Примечание Комплект драйверов Microsoft Windows (WDK) не содержит драйверы дисплея 3Dlabs Permedia2 (3dlabs.htm ) и 3Dlabs Permedia3 (Perm3.htm). Эти примеры драйверов можно получить из пакета средств разработки драйверов Windows Server 2003 с пакетом обновления 1 (SP1), который можно скачать на странице пакета средств разработки драйверов Для Windows ( DDK ) на веб-сайте WDHC.

Требования


Целевая платформа	Рабочий стол
Верхняя часть	winddi.h (include Winddi.h)

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