Функция WdfDriverIsVersionAvailable (wdfdriver.h)

  • Статья

[Применимо к KMDF и UMDF]

Метод WdfDriverIsVersionAvailable возвращает логическое значение, указывающее, работает ли драйвер с указанной версией библиотеки Kernel-Mode Driver Framework.

Синтаксис

BOOLEAN WdfDriverIsVersionAvailable(
  [in] WDFDRIVER                            Driver,
  [in] PWDF_DRIVER_VERSION_AVAILABLE_PARAMS VersionAvailableParams
);

Параметры

[in] Driver

Дескриптор объекта драйвера платформы драйвера, который драйвер получил при предыдущем вызове WdfDriverCreate или WdfGetDriver.

[in] VersionAvailableParams

Указатель на структуру WDF_DRIVER_VERSION_AVAILABLE_PARAMS , которая определяет версию библиотеки платформы.

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

WdfDriverIsVersionAvailable возвращает значение TRUE , если драйвер работает с версией библиотеки, указанной параметром VersionAvailableParams .

Метод возвращает значение FALSE , если драйвер не работает с указанной версией библиотеки или если структура WDF_DRIVER_VERSION_AVAILABLE_PARAMS недопустима.

Системная ошибка проверка возникает, если дескриптор драйвера недопустим.

Комментарии

Дополнительные сведения о версиях библиотек см. в разделе Управление версиями библиотеки платформы.

Примеры

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

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

WDF_DRIVER_VERSION_AVAILABLE_PARAMS_INIT(&ver, 1, 0);
if (!WdfDriverIsVersionAvailable(
                                 driver,
                                 &ver
                                 )) {
    DbgPrint("Unexpected library version.\n");
}

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfdriver.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver