Структура OSVERSIONINFOEXW (wdm.h)

Структура RTL_OSVERSIONINFOEXW содержит сведения о версии операционной системы.

Синтаксис

typedef struct _OSVERSIONINFOEXW {
  ULONG  dwOSVersionInfoSize;
  ULONG  dwMajorVersion;
  ULONG  dwMinorVersion;
  ULONG  dwBuildNumber;
  ULONG  dwPlatformId;
  WCHAR  szCSDVersion[128];
  USHORT wServicePackMajor;
  USHORT wServicePackMinor;
  USHORT wSuiteMask;
  UCHAR  wProductType;
  UCHAR  wReserved;
} OSVERSIONINFOEXW, *POSVERSIONINFOEXW, *LPOSVERSIONINFOEXW, RTL_OSVERSIONINFOEXW, *PRTL_OSVERSIONINFOEXW;

Члены

dwOSVersionInfoSize

Размер структуры RTL_OSVERSIONINFOEXW в байтах. Этот элемент необходимо задать перед использованием структуры с RtlGetVersion.

dwMajorVersion

Основной номер версии операционной системы. Например, для Windows 2000 основной номер версии — пять. Дополнительные сведения см. в таблице в разделе Примечания.

dwMinorVersion

Дополнительный номер версии операционной системы. Например, для Windows 2000 дополнительный номер версии равен нулю. Дополнительные сведения см. в таблице в разделе Примечания.

dwBuildNumber

Номер сборки операционной системы.

dwPlatformId

Платформа операционной системы. Для Win32 в операционных системах на основе NT функция RtlGetVersion возвращает значение VER_PLATFORM_WIN32_NT.

szCSDVersion[128]

Строка версии пакета обновления. Этот элемент содержит строку, завершающуюся нулевым значением, например "Пакет обновления 3", который указывает на последний пакет обновления, установленный в системе. Если пакет обновления не установлен, RtlGetVersion может не инициализировать эту строку. Инициализируйте szCSDVersion равным нулю (пустую строку) перед вызовом RtlGetVersion.

wServicePackMajor

Номер основной версии последнего пакета обновления, установленного в системе. Например, для пакета обновления 3 основной номер версии — три. Если пакет обновления не установлен, значение равно нулю.

wServicePackMinor

Номер дополнительной версии последнего пакета обновления, установленного в системе. Например, для пакета обновления 3 номер дополнительной версии равен нулю.

wSuiteMask

Наборы продуктов, доступные в системе. Для этого элемента задано значение ноль или побитовое ИЛИ одного или нескольких из следующих значений.

Не следует полагаться только на флаг VER_SUITE_SMALLBUSINESS, чтобы определить, установлен ли в настоящее время Small Business Server. Этот и VER_SUITE_SMALLBUSINESS_RESTRICTED флаг устанавливаются при установке этого набора продуктов. Если вы обновите эту установку до Windows Server Standard Edition, флаг VER_SUITE_SMALLBUSINESS_RESTRICTED будет снят, но флаг VER_SUITE_SMALLBUSINESS остается установленным, что в данном случае означает, что в этой системе ранее был установлен Сервер Small Business Server. Если эта установка будет обновлена до Windows Server, выпуск Enterprise, флаг VER_SUITE_SMALLBUSINESS остается установленным.

wProductType

Тип продукта. Этот элемент содержит дополнительные сведения о системе. Этот элемент может иметь одно из следующих значений:

wReserved

Зарезервировано для последующего использования.

Комментарии

Сведения в этой структуре включают номера основных и дополнительных версий, номер сборки, идентификатор платформы, установленные наборы продуктов и последний пакет обновления, установленный в системе. Эта структура используется с подпрограммами RtlGetVersion и RtlVerifyVersionInfo .

Использование сведений о версии не всегда является лучшим способом проверки доступности компонента. Инструкции см. в документации по интересующей вас функции.

По возможности разработайте код обнаружения версий в драйвере, чтобы он мог работать в будущих версиях Windows. Если драйверу требуется определенная версия операционной системы, не забудьте рассматривать эту версию как минимальную поддерживаемую версию, а не как единственную версию, в которой можно запустить драйвер.

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

Только 64-разрядный драйвер в режиме ядра может работать в Windows XP Professional x64 Edition. Таким образом, 32-разрядный драйвер в режиме ядра может безопасно опустить проверку для этой версии Windows.

Требования

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

RTL_OSVERSIONINFOW

RtlGetVersion

RtlVerifyVersionInfo