1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef BASE_WIN_WINDOWS_VERSION_H_
#define BASE_WIN_WINDOWS_VERSION_H_
#include <stddef.h>
#include <string>
#include "base/base_export.h"
#include "base/gtest_prod_util.h"
#include "base/macros.h"
#include "base/version.h"
using HANDLE = void*;
struct _OSVERSIONINFOEXW;
struct _SYSTEM_INFO;
namespace base {
namespace test {
class ScopedOSInfoOverride;
} // namespace test
} // namespace base
namespace base {
namespace win {
// The running version of Windows. This is declared outside OSInfo for
// syntactic sugar reasons; see the declaration of GetVersion() below.
// NOTE: Keep these in order so callers can do things like
// "if (base::win::GetVersion() >= base::win::Version::VISTA) ...".
//
// This enum is used in metrics histograms, so they shouldn't be reordered or
// removed. New values can be added before Version::WIN_LAST.
enum class Version {
PRE_XP = 0, // Not supported.
XP = 1,
SERVER_2003 = 2, // Also includes XP Pro x64 and Server 2003 R2.
VISTA = 3, // Also includes Windows Server 2008.
WIN7 = 4, // Also includes Windows Server 2008 R2.
WIN8 = 5, // Also includes Windows Server 2012.
WIN8_1 = 6, // Also includes Windows Server 2012 R2.
WIN10 = 7, // Threshold 1: Version 1507, Build 10240.
WIN10_TH2 = 8, // Threshold 2: Version 1511, Build 10586.
WIN10_RS1 = 9, // Redstone 1: Version 1607, Build 14393.
WIN10_RS2 = 10, // Redstone 2: Version 1703, Build 15063.
WIN10_RS3 = 11, // Redstone 3: Version 1709, Build 16299.
WIN10_RS4 = 12, // Redstone 4: Version 1803, Build 17134.
WIN10_RS5 = 13, // Redstone 5: Version 1809, Build 17763.
WIN10_19H1 = 14, // 19H1: Version 1903, Build 18362.
WIN10_20H1 = 15, // 20H1: Version 2004, Build 19041.
// On edit, update tools\metrics\histograms\enums.xml "WindowsVersion" and
// "GpuBlacklistFeatureTestResultsWindows2".
WIN_LAST, // Indicates error condition.
};
// A rough bucketing of the available types of versions of Windows. This is used
// to distinguish enterprise enabled versions from home versions and potentially
// server versions. Keep these values in the same order, since they are used as
// is for metrics histogram ids.
enum VersionType {
SUITE_HOME = 0,
SUITE_PROFESSIONAL,
SUITE_SERVER,
SUITE_ENTERPRISE,
SUITE_EDUCATION,
SUITE_LAST,
};
// A singleton that can be used to query various pieces of information about the
// OS and process state. Note that this doesn't use the base Singleton class, so
// it can be used without an AtExitManager.
class BASE_EXPORT OSInfo {
public:
struct VersionNumber {
int major;
int minor;
int build;
int patch;
};
struct ServicePack {
int major;
int minor;
};
// The processor architecture this copy of Windows natively uses. For
// example, given an x64-capable processor, we have three possibilities:
// 32-bit Chrome running on 32-bit Windows: X86_ARCHITECTURE
// 32-bit Chrome running on 64-bit Windows via WOW64: X64_ARCHITECTURE
// 64-bit Chrome running on 64-bit Windows: X64_ARCHITECTURE
enum WindowsArchitecture {
X86_ARCHITECTURE,
X64_ARCHITECTURE,
IA64_ARCHITECTURE,
ARM64_ARCHITECTURE,
OTHER_ARCHITECTURE,
};
// Whether a process is running under WOW64 (the wrapper that allows 32-bit
// processes to run on 64-bit versions of Windows). This will return
// WOW64_DISABLED for both "32-bit Chrome on 32-bit Windows" and "64-bit
// Chrome on 64-bit Windows". WOW64_UNKNOWN means "an error occurred", e.g.
// the process does not have sufficient access rights to determine this.
enum WOW64Status {
WOW64_DISABLED,
WOW64_ENABLED,
WOW64_UNKNOWN,
};
static OSInfo* GetInstance();
// Separate from the rest of OSInfo so it can be used during early process
// initialization.
static WindowsArchitecture GetArchitecture();
// Like wow64_status(), but for the supplied handle instead of the current
// process. This doesn't touch member state, so you can bypass the singleton.
static WOW64Status GetWOW64StatusForProcess(HANDLE process_handle);
const Version& version() const { return version_; }
Version Kernel32Version() const;
Version UcrtVersion() const;
base::Version Kernel32BaseVersion() const;
// The next two functions return arrays of values, [major, minor(, build)].
const VersionNumber& version_number() const { return version_number_; }
const VersionType& version_type() const { return version_type_; }
const ServicePack& service_pack() const { return service_pack_; }
const std::string& service_pack_str() const { return service_pack_str_; }
const int& processors() const { return processors_; }
const size_t& allocation_granularity() const {
return allocation_granularity_;
}
const WOW64Status& wow64_status() const { return wow64_status_; }
std::string processor_model_name();
const std::string& release_id() const { return release_id_; }
private:
friend class base::test::ScopedOSInfoOverride;
FRIEND_TEST_ALL_PREFIXES(OSInfo, MajorMinorBuildToVersion);
static OSInfo** GetInstanceStorage();
OSInfo(const _OSVERSIONINFOEXW& version_info,
const _SYSTEM_INFO& system_info,
int os_type);
~OSInfo();
// Returns a Version value for a given OS version tuple.
static Version MajorMinorBuildToVersion(int major, int minor, int build);
Version version_;
VersionNumber version_number_;
VersionType version_type_;
ServicePack service_pack_;
// Represents the version of the OS associated to a release of
// Windows 10. Each version may have different releases (such as patch
// updates). This is the identifier of the release.
// Example:
// Windows 10 Version 1809 (OS build 17763) has multiple releases
// (i.e. build 17763.1, build 17763.195, build 17763.379, ...).
// See https://docs.microsoft.com/en-us/windows/windows-10/release-information
// for more information.
std::string release_id_;
// A string, such as "Service Pack 3", that indicates the latest Service Pack
// installed on the system. If no Service Pack has been installed, the string
// is empty.
std::string service_pack_str_;
int processors_;
size_t allocation_granularity_;
WOW64Status wow64_status_;
std::string processor_model_name_;
DISALLOW_COPY_AND_ASSIGN(OSInfo);
};
// Because this is by far the most commonly-requested value from the above
// singleton, we add a global-scope accessor here as syntactic sugar.
BASE_EXPORT Version GetVersion();
} // namespace win
} // namespace base
#endif // BASE_WIN_WINDOWS_VERSION_H_
|
