Структура 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]

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

wServicePackMajor

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

wServicePackMinor

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

wSuiteMask

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

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

wProductType

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

wReserved

Зарезервировано для дальнейшего использования.

Замечания

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

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

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

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

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

Требования

См. также

RTL_OSVERSIONINFOW

RtlGetVersion

RtlVerifyVersionInfo