base/win/windows_version.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef BASE_WIN_WINDOWS_VERSION_H_
   6 #define BASE_WIN_WINDOWS_VERSION_H_
   7
   8 #include <string>
   9
  10 #include "base/base_export.h"
  11 #include "base/basictypes.h"
  12
  13 typedef void* HANDLE;
  14
  15 namespace base {
  16 namespace win {
  17
  18 // The running version of Windows.  This is declared outside OSInfo for
  19 // syntactic sugar reasons; see the declaration of GetVersion() below.
  20 // NOTE: Keep these in order so callers can do things like
  21 // "if (base::win::GetVersion() >= base::win::VERSION_VISTA) ...".
  22 enum Version {
  23   VERSION_PRE_XP = 0,  // Not supported.
  24   VERSION_XP,
  25   VERSION_SERVER_2003, // Also includes XP Pro x64 and Server 2003 R2.
  26   VERSION_VISTA,       // Also includes Windows Server 2008.
  27   VERSION_WIN7,        // Also includes Windows Server 2008 R2.
  28   VERSION_WIN8,        // Also includes Windows Server 2012.
  29   VERSION_WIN8_1,      // Also includes Windows Server 2012 R2.
  30   VERSION_WIN10,       // Also includes Windows 10 Server.
  31   VERSION_WIN_LAST,    // Indicates error condition.
  32 };
  33
  34 // A rough bucketing of the available types of versions of Windows. This is used
  35 // to distinguish enterprise enabled versions from home versions and potentially
  36 // server versions.
  37 enum VersionType {
  38   SUITE_HOME,
  39   SUITE_PROFESSIONAL,
  40   SUITE_SERVER,
  41   SUITE_LAST,
  42 };
  43
  44 // A singleton that can be used to query various pieces of information about the
  45 // OS and process state. Note that this doesn't use the base Singleton class, so
  46 // it can be used without an AtExitManager.
  47 class BASE_EXPORT OSInfo {
  48  public:
  49   struct VersionNumber {
  50     int major;
  51     int minor;
  52     int build;
  53   };
  54
  55   struct ServicePack {
  56     int major;
  57     int minor;
  58   };
  59
  60   // The processor architecture this copy of Windows natively uses.  For
  61   // example, given an x64-capable processor, we have three possibilities:
  62   //   32-bit Chrome running on 32-bit Windows:           X86_ARCHITECTURE
  63   //   32-bit Chrome running on 64-bit Windows via WOW64: X64_ARCHITECTURE
  64   //   64-bit Chrome running on 64-bit Windows:           X64_ARCHITECTURE
  65   enum WindowsArchitecture {
  66     X86_ARCHITECTURE,
  67     X64_ARCHITECTURE,
  68     IA64_ARCHITECTURE,
  69     OTHER_ARCHITECTURE,
  70   };
  71
  72   // Whether a process is running under WOW64 (the wrapper that allows 32-bit
  73   // processes to run on 64-bit versions of Windows).  This will return
  74   // WOW64_DISABLED for both "32-bit Chrome on 32-bit Windows" and "64-bit
  75   // Chrome on 64-bit Windows".  WOW64_UNKNOWN means "an error occurred", e.g.
  76   // the process does not have sufficient access rights to determine this.
  77   enum WOW64Status {
  78     WOW64_DISABLED,
  79     WOW64_ENABLED,
  80     WOW64_UNKNOWN,
  81   };
  82
  83   static OSInfo* GetInstance();
  84
  85   Version version() const { return version_; }
  86   // The next two functions return arrays of values, [major, minor(, build)].
  87   VersionNumber version_number() const { return version_number_; }
  88   VersionType version_type() const { return version_type_; }
  89   ServicePack service_pack() const { return service_pack_; }
  90   WindowsArchitecture architecture() const { return architecture_; }
  91   int processors() const { return processors_; }
  92   size_t allocation_granularity() const { return allocation_granularity_; }
  93   WOW64Status wow64_status() const { return wow64_status_; }
  94   std::string processor_model_name();
  95
  96   // Like wow64_status(), but for the supplied handle instead of the current
  97   // process.  This doesn't touch member state, so you can bypass the singleton.
  98   static WOW64Status GetWOW64StatusForProcess(HANDLE process_handle);
  99
 100  private:
 101   OSInfo();
 102   ~OSInfo();
 103
 104   Version version_;
 105   VersionNumber version_number_;
 106   VersionType version_type_;
 107   ServicePack service_pack_;
 108   WindowsArchitecture architecture_;
 109   int processors_;
 110   size_t allocation_granularity_;
 111   WOW64Status wow64_status_;
 112   std::string processor_model_name_;
 113
 114   DISALLOW_COPY_AND_ASSIGN(OSInfo);
 115 };
 116
 117 // Because this is by far the most commonly-requested value from the above
 118 // singleton, we add a global-scope accessor here as syntactic sugar.
 119 BASE_EXPORT Version GetVersion();
 120
 121 }  // namespace win
 122 }  // namespace base
 123
 124 #endif  // BASE_WIN_WINDOWS_VERSION_H_