Метод 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 |