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

Структура DRVENABLEDATA (winddi.h)

  • Статья

Структура DRVENABLEDATA содержит указатель на массив структур DRVFN и графический номер версии DDI операционной системы на основе NT.

Синтаксис

typedef struct tagDRVENABLEDATA {
  ULONG iDriverVersion;
  ULONG c;
  DRVFN *pdrvfn;
} DRVENABLEDATA, *PDRVENABLEDATA;

Члены

iDriverVersion

Указывает номер версии графического DDI операционной системы на основе NT, для которых предназначен драйвер. Для этого элемента можно задать одно из следующих значений:

Значение Версия операционной системы
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)
 

Дополнительные сведения см. в разделе "Примечания".

c

Указывает количество структур DRVFN в буфере, на который указывает член pdrvfn .

pdrvfn

Указатель на буфер, содержащий массив структур DRVFN .

Комментарии

Для запуска в этих версиях операционных систем на основе NT необходимо задать элемент iDriverVersion следующим образом:

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

Как показано в таблице, драйвер может работать в любой из этих версий операционной системы, если для iDriverVersion задано значение DDI_DRIVER_VERSION_NT4, но драйвер может работать только в Windows XP и более поздних версиях операционной системы, если для iDriverVersion задано значение DDI_DRIVER_VERSION_NT5_01.

Примечание Если драйвер реализует графический DDI DrvXxx, который поддерживается не во всех версиях Windows, драйвер не может указать запись DRVFN для этого графического DDI при запуске в версиях Windows, которые не поддерживают его. Если драйвер указывает запись DRVFN для такого графического DDI, Windows отклонит драйвер. В примере permedia2 показано, как указать различные структуры DRVFN для разных версий Windows.
 

Требования

Требование Значение
Заголовок winddi.h (включая Winddi.h)

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

DRVFN

DrvEnableDriver