Метод IPortClsVersion::GetVersion (portcls.h)

  • Статья

Метод GetVersion возвращает версию операционной системы Windows, в котором работает драйвер.

Синтаксис

DWORD GetVersion();

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

Метод GetVersion возвращает значение DWORD, указывающее номер версии Windows. Дополнительные сведения см. в разделе "Примечания".

Комментарии

Метод GetVersion возвращает сведения о версии, указывающие выпуск Windows.

Возможные номера версий Windows, которые GetVersion могут возвращать, приведены в следующей таблице.

Номер версии Версия Windows Поддерживает
kVersionWin98 Windows 98 нет
kVersionWin98SE Windows 98 Second Edition нет
kVersionWin2K Windows 2000 нет
kVersionWin98SE_QFE2 Windows 98 SE + пакет Hot-Fix 269601.) нет
kVersionWin2K_SP2 Windows 2000 с пакетом обновления 2 (SP2) YES
kVersionWinME Windows Me нет
kVersionWin98SE_QFE3 Зарезервировано для использования в будущем. YES
kVersionWinME_QFE1 Зарезервировано для использования в будущем. YES
kVersionWinXP Windows XP YES
kVersionWinXPSP1 Windows XP + пакет обновления 1 (SP1) YES
kVersionWinServer2003 Windows Server 2003 YES
kVersionWin2K_UAAQFE Windows 2000 + пакет горячего исправления с поддержкой IUnregister_Xxx_ (см. раздел Dynamic Audio Subvices.) YES
kVersionWinXP_UAAQFE Windows XP + пакет горячего исправления с поддержкой IUnregister_Xxx_ (см. раздел Dynamic Audio Subvices.) YES
kVersionWinServer2003_UAAQFE Windows Server 2003 + пакет горячего исправления с поддержкой IUnregister_Xxx_ (см. раздел Dynamic Audio Subvices.) YES

Номера версий в предыдущей таблице определяются в файле заголовка portcls.h. Обратите внимание, что portcls.h определяет номера версий как для версий Windows, которые поддерживают интерфейс IPortClsVersion , так и не поддерживают его. Оба типа номера версии могут быть полезны. Драйвер мини-порта обычно содержит проприетарную подпрограмму, которая определяет версию Windows и может возвращать любой номер версии из предыдущей таблицы. При выполнении на платформе, которая не поддерживает IPortClsVersion, эта подпрограмма должна использовать другие тесты программного обеспечения для определения версии Windows. Эти тесты обычно используют функцию IoIsWdmVersionAvailable . Пример кода такой подпрограммы см. в примере аудиодрайвера sb16 в комплекте драйверов Windows (WDK).

Номера версий в предыдущей таблице перечислены примерно в хронологическом порядке. Каждая последующая версия Windows в таблице не обязательно представляет собой надмножество функций предыдущей версии. Например, версия, представленная kVersionWin2K , имеет больше возможностей звука, чем версия, представленная kVersionWin98SE_QFE2.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть portcls.h (включая Portcls.h)
IRQL PASSIVE_LEVEL

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

IPortClsVersion

IoIsWdmVersionAvailable