структура UMDF_VERSION_DATA (wudfddi_types.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Структура UMDF_VERSION_DATA описывает версию платформы.

Синтаксис

typedef struct UMDF_VERSION_DATA {
  ULONG MajorNumber;
  ULONG MinorNumber;
  ULONG ServiceNumber;
} UMDF_VERSION_DATA, *PUMDF_VERSION_DATA;

Члены

MajorNumber

Число, указывающее основную версию платформы.

MinorNumber

Число, указывающее дополнительную версию платформы.

ServiceNumber

Число, указывающее службу платформы.

Комментарии

Драйвер UMDF предоставляет указатель на структуру UMDF_VERSION_DATA на метод IWDFDriver::IsVersionAvailable , чтобы описать минимальную версию платформы, которую поддерживает драйвер.

Примечание. UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.
 

Microsoft_WDF_UMDF_Version — это глобальная переменная типа UMDF_VERSION_DATA , указывающая основную, дополнительную версию и номер службы для текущего выпуска платформы.

Например, в Windows 8 Wudfddi.h указывает:

UMDF_VERSION_DATA Microsoft_WDF_UMDF_Version = {1, 11,  0}

При компиляции драйвера с помощью Wudfddi.h Microsoft_WDF_UMDF_Version включается в двоичный файл драйвера и экспортируется с помощью __declspec(dllexport).

Когда система загружает драйвер, хост-процесс (WUDFHost.exe) проверяет, соответствует ли основная версия драйвера основной версии платформы и что дополнительная версия драйвера меньше или равна дополнительной версии платформы.

Драйверу не нужно предпринимать никаких действий для предоставления этого номера версии платформе, кроме сборки с помощью Wudfddi.h.

Окончание поддержки: недоступно в UMDF 2.0 и более поздних версиях.

Минимальная версия UMDF: 1.0

Заголовок: Wudfddi.h (включая Wudfddi.h)

Требования

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

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

IWDFDriver::IsVersionAvailable

Microsoft_WDF_UMDF_Version