summaryrefslogtreecommitdiffstats
path: root/gfx/src/gfxTelemetry.h
diff options
context:
space:
mode:
Diffstat (limited to 'gfx/src/gfxTelemetry.h')
-rw-r--r--gfx/src/gfxTelemetry.h93
1 files changed, 93 insertions, 0 deletions
diff --git a/gfx/src/gfxTelemetry.h b/gfx/src/gfxTelemetry.h
new file mode 100644
index 0000000000..37d603674a
--- /dev/null
+++ b/gfx/src/gfxTelemetry.h
@@ -0,0 +1,93 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+#ifndef gfx_src_gfxTelemetry_h__
+#define gfx_src_gfxTelemetry_h__
+
+#include <cstdint>
+
+namespace mozilla {
+namespace gfx {
+
+// Describes the status of a graphics feature, in terms of whether or not we've
+// attempted to initialize the feature, and if so, whether or not it succeeded
+// (and if not, why).
+enum class FeatureStatus {
+ // This feature has not been requested.
+ Unused,
+
+ // This feature is unavailable due to Safe Mode, not being included with
+ // the operating system, or a dependent feature being disabled.
+ Unavailable,
+ UnavailableInSafeMode,
+ UnavailableNoGpuProcess,
+ UnavailableNoHwCompositing,
+ UnavailableNotBuilt,
+ UnavailableNoAngle,
+ UnavailableNoWebRender,
+
+ // This feature crashed immediately when we tried to initialize it, but we
+ // were able to recover via SEH (or something similar).
+ CrashedInHandler,
+
+ // This feature was blocked for reasons outside the blocklist, such as a
+ // runtime test failing.
+ Blocked,
+ BlockedDeviceUnknown,
+ BlockedDeviceTooOld,
+ BlockedVendorUnsupported,
+ BlockedHasBattery,
+ BlockedScreenTooLarge,
+ BlockedScreenUnknown,
+ BlockedNoGfxInfo,
+ BlockedOverride,
+ BlockedReleaseChannelIntel,
+ BlockedReleaseChannelAMD,
+ BlockedReleaseChannelNvidia,
+ BlockedReleaseChannelBattery,
+ BlockedReleaseChannelAndroid,
+
+ // This feature has been blocked by the allowlist.
+ Denied,
+
+ // This feature has been blocked by the graphics blocklist.
+ Blocklisted,
+
+ // This feature is disabled by default, and so activation isn't attempted
+ // unless something explicitly enables it.
+ OptIn,
+
+ // This feature was attempted but failed to activate.
+ Failed,
+
+ // This feature was explicitly disabled by the user.
+ Disabled,
+
+ // This feature is available for use.
+ Available,
+
+ // This feature was explicitly force-enabled by the user.
+ ForceEnabled,
+
+ // This feature was disabled due to the startup crash guard.
+ CrashedOnStartup,
+
+ // This feature was attempted but later determined to be broken.
+ Broken,
+
+ // Add new entries above here.
+ LAST
+};
+
+const char* FeatureStatusToString(FeatureStatus aStatus);
+bool IsFeatureStatusFailure(FeatureStatus aStatus);
+bool IsFeatureStatusSuccess(FeatureStatus aStatus);
+
+enum class TelemetryDeviceCode : uint32_t { Content = 0, Image = 1, D2D1 = 2 };
+
+} // namespace gfx
+} // namespace mozilla
+
+#endif // gfx_src_gfxTelemetry_h__