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