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

Статья
03/13/2024

Функция DrvEnableDriver — это начальная точка входа драйвера, экспортируемая библиотекой DLL драйвера. Он заполняет структуру DRVENABLEDATA номером версии DDI графического драйвера и вызывающими адресами всех графических функций DDI, поддерживаемых драйвером.

Синтаксис

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

Параметры

iEngineVersion

Определяет версию GDI, которая выполняется в данный момент.

cj

Размер структуры в байтах, на которую указывает pded. Если структура больше, чем ожидалось, дополнительные элементы следует оставить без изменений.

[in] pded

Указатель на структуру DRVENABLEDATA . GDI с нуля инициализирует cj-байты перед вызовом. Драйвер заполняет собственные данные.

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

Возвращаемое значение равно TRUE , если указанный драйвер включен. В противном случае это значение false, а код ошибки записывается в журнал.

DrvEnableDriver должен быть реализован во всех графических драйверах. Если вы используете средства сборки пакета драйверов Windows (WDK) и для параметра TARGETTYPE установлено значение GDI_DRIVER (см. раздел Создание библиотеки DLL графики принтера), эта функция должна называться DrvEnableDriver. Это единственная функция драйвера отображения, доступ к которому должен осуществляться по имени. Доступ ко всем остальным функциям драйвера дисплея осуществляется через указатели функций; Поэтому их имена представлены в этой документации как псевдоимя.

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

При проверке версии с помощью значения, указанного в iEngineVersion, драйвер должен использовать соответствующую константу DDI_DRIVER_VERSION_Xxx (определенную в winddi.h), показанную в следующей таблице. Драйверы почти никогда не должны проверка только для равенства, так как в будущем будут выпущены новые версии и пакеты обновления для операционной системы. Дополнительные сведения см. в разделе DRVENABLEDATA.

Значение	Версия операционной системы
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 с пакетом обновления 3 (SP3)
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP с пакетом обновления 1 (SP1)