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,      // Code named Windows Blue
  30   VERSION_WIN_LAST,    // Indicates error condition.
  31 };
  32
  33 // A rough bucketing of the available types of versions of Windows. This is used
  34 // to distinguish enterprise enabled versions from home versions and potentially
  35 // server versions.
  36 enum VersionType {
  37   SUITE_HOME,
  38   SUITE_PROFESSIONAL,
  39   SUITE_SERVER,
  40   SUITE_LAST,
  41 };
  42
  43 // A singleton that can be used to query various pieces of information about the
  44 // OS and process state. Note that this doesn't use the base Singleton class, so
  45 // it can be used without an AtExitManager.
  46 class BASE_EXPORT OSInfo {
  47  public:
  48   struct VersionNumber {
  49     int major;
  50     int minor;
  51     int build;
  52   };
  53
  54   struct ServicePack {
  55     int major;
  56     int minor;
  57   };
  58
  59   // The processor architecture this copy of Windows natively uses.  For
  60   // example, given an x64-capable processor, we have three possibilities:
  61   //   32-bit Chrome running on 32-bit Windows:           X86_ARCHITECTURE
  62   //   32-bit Chrome running on 64-bit Windows via WOW64: X64_ARCHITECTURE
  63   //   64-bit Chrome running on 64-bit Windows:           X64_ARCHITECTURE
  64   enum WindowsArchitecture {
  65     X86_ARCHITECTURE,
  66     X64_ARCHITECTURE,
  67     IA64_ARCHITECTURE,
  68     OTHER_ARCHITECTURE,
  69   };
  70
  71   // Whether a process is running under WOW64 (the wrapper that allows 32-bit
  72   // processes to run on 64-bit versions of Windows).  This will return
  73   // WOW64_DISABLED for both "32-bit Chrome on 32-bit Windows" and "64-bit
  74   // Chrome on 64-bit Windows".  WOW64_UNKNOWN means "an error occurred", e.g.
  75   // the process does not have sufficient access rights to determine this.
  76   enum WOW64Status {
  77     WOW64_DISABLED,
  78     WOW64_ENABLED,
  79     WOW64_UNKNOWN,
  80   };
  81
  82   static OSInfo* GetInstance();
  83
  84   Version version() const { return version_; }
  85   // The next two functions return arrays of values, [major, minor(, build)].
  86   VersionNumber version_number() const { return version_number_; }
  87   VersionType version_type() const { return version_type_; }
  88   ServicePack service_pack() const { return service_pack_; }
  89   WindowsArchitecture architecture() const { return architecture_; }
  90   int processors() const { return processors_; }
  91   size_t allocation_granularity() const { return allocation_granularity_; }
  92   WOW64Status wow64_status() const { return wow64_status_; }
  93   std::string processor_model_name();
  94
  95   // Like wow64_status(), but for the supplied handle instead of the current
  96   // process.  This doesn't touch member state, so you can bypass the singleton.
  97   static WOW64Status GetWOW64StatusForProcess(HANDLE process_handle);
  98
  99  private:
 100   OSInfo();
 101   ~OSInfo();
 102
 103   Version version_;
 104   VersionNumber version_number_;
 105   VersionType version_type_;
 106   ServicePack service_pack_;
 107   WindowsArchitecture architecture_;
 108   int processors_;
 109   size_t allocation_granularity_;
 110   WOW64Status wow64_status_;
 111   std::string processor_model_name_;
 112
 113   DISALLOW_COPY_AND_ASSIGN(OSInfo);
 114 };
 115
 116 // Because this is by far the most commonly-requested value from the above
 117 // singleton, we add a global-scope accessor here as syntactic sugar.
 118 BASE_EXPORT Version GetVersion();
 119
 120 }  // namespace win
 121 }  // namespace base
 122
 123 #endif  // BASE_WIN_WINDOWS_VERSION_H_