// Copyright 2020-2023, Collabora, Ltd.
// Copyright 2024-2026, NVIDIA CORPORATION.
// SPDX-License-Identifier: BSL-1.0
/*!
 * @file
 * @brief  Internal result type for XRT.
 * @author Christoph Haag <christoph.haag@collabora.com>
 * @ingroup xrt_iface
 */

#pragma once

/*!
 * Result type used across Monado.
 *
 * 0 is @ref XRT_SUCCESS, positive values are "special" non-error return codes (like timeout), negative values are
 * errors.
 *
 * @see u_pp_xrt_result
 * @ingroup xrt_iface
 */
typedef enum xrt_result
{
	/*!
	 * The operation succeeded
	 */
	XRT_SUCCESS = 0,

	/*!
	 * The operation was given a timeout and timed out.
	 *
	 * The value 2 picked so it matches VK_TIMEOUT.
	 */
	XRT_TIMEOUT = 2,

	/*!
	 * The space’s bounds are not known at the moment.
	 */
	XRT_SPACE_BOUNDS_UNAVAILABLE = 3,

	/*!
	 * An (asynchronous) operation has been cancelled.
	 */
	XRT_OPERATION_CANCELLED = 4,

	/*!
	 * A problem occurred either with the IPC transport itself, with invalid commands from the client, or with
	 * invalid responses from the server.
	 */
	XRT_ERROR_IPC_FAILURE = -1,

	/*!
	 * Returned when trying to acquire or release an image and there is no image left to acquire/no space in the
	 * queue left to release to
	 */
	XRT_ERROR_NO_IMAGE_AVAILABLE = -2,

	/*!
	 * Other unspecified error related to Vulkan
	 */
	XRT_ERROR_VULKAN = -3,

	/*!
	 * Other unspecified error related to OpenGL
	 */
	XRT_ERROR_OPENGL = -4,

	/*!
	 * The function tried to submit Vulkan commands but received an error.
	 */
	XRT_ERROR_FAILED_TO_SUBMIT_VULKAN_COMMANDS = -5,

	/*!
	 *
	 * Returned when a swapchain create flag is passed that is valid, but
	 * not supported by the main compositor (and lack of support is also
	 * valid).
	 *
	 * For use when e.g. the protected content image flag is requested but
	 * isn't supported.
	 */
	XRT_ERROR_SWAPCHAIN_FLAG_VALID_BUT_UNSUPPORTED = -6,

	/*!
	 * Could not allocate native image buffer(s).
	 */
	XRT_ERROR_ALLOCATION = -7,

	/*!
	 * The pose is no longer active, this happens when the application
	 * tries to get a pose that is no longer active.
	 */
	XRT_ERROR_POSE_NOT_ACTIVE = -8,

	/*!
	 * Creating a fence failed.
	 */
	XRT_ERROR_FENCE_CREATE_FAILED = -9,

	/*!
	 * Getting or giving the native fence handle caused a error.
	 */
	XRT_ERROR_NATIVE_HANDLE_FENCE_ERROR = -10,

	/*!
	 * Multiple not supported on this layer level (IPC, compositor).
	 */
	XRT_ERROR_MULTI_SESSION_NOT_IMPLEMENTED = -11,

	/*!
	 * The requested format is not supported by Monado.
	 */
	XRT_ERROR_SWAPCHAIN_FORMAT_UNSUPPORTED = -12,

	/*!
	 * The given config was EGL_NO_CONFIG_KHR and EGL_KHR_no_config_context
	 * is not supported by the display.
	 */
	XRT_ERROR_EGL_CONFIG_MISSING = -13,

	/*!
	 * Failed to initialize threading components.
	 */
	XRT_ERROR_THREADING_INIT_FAILURE = -14,

	/*!
	 * The client has not created a session on this IPC connection,
	 * which is needed for the given command.
	 */
	XRT_ERROR_IPC_SESSION_NOT_CREATED = -15,

	/*!
	 * The client has already created a session on this IPC connection.
	 */
	XRT_ERROR_IPC_SESSION_ALREADY_CREATED = -16,
	/*!
	 * The prober list has not been locked before this call.
	 */
	XRT_ERROR_PROBER_NOT_SUPPORTED = -17,
	/*!
	 * Creating the @ref xrt_prober failed.
	 */
	XRT_ERROR_PROBER_CREATION_FAILED = -18,
	/*!
	 * The prober list is locked (already).
	 */
	XRT_ERROR_PROBER_LIST_LOCKED = -19,
	/*!
	 * The prober list has not been locked before this call.
	 */
	XRT_ERROR_PROBER_LIST_NOT_LOCKED = -20,
	/*!
	 * The probring failed.
	 */
	XRT_ERROR_PROBING_FAILED = -21,
	/*!
	 * Creating a @ref xrt_device failed.
	 */
	XRT_ERROR_DEVICE_CREATION_FAILED = -22,
	/*!
	 * Some D3D error, from code shared between D3D11 and D3D12
	 */
	XRT_ERROR_D3D = -23,
	/*!
	 * Some D3D11 error
	 */
	XRT_ERROR_D3D11 = -24,
	/*!
	 * Some D3D12 error
	 */
	XRT_ERROR_D3D12 = -25,
	/*!
	 * The @ref xrt_space_overseer doesn't support recentering driven from
	 * the application side of things.
	 */
	XRT_ERROR_RECENTERING_NOT_SUPPORTED = -26,
	/*!
	 * The system doesn't support compositor, this error can be returned
	 * when trying to create the system compositor or trying to create the
	 * native compositor.
	 */
	XRT_ERROR_COMPOSITOR_NOT_SUPPORTED = -27,
	/*!
	 * The client has not created a compositor on this IPC connection,
	 * which is needed for the given command.
	 */
	XRT_ERROR_IPC_COMPOSITOR_NOT_CREATED = -28,

	/*!
	 * The interface function called is not implemented by its interface.
	 */
	XRT_ERROR_NOT_IMPLEMENTED = -29,

	/*!
	 * The supplied space type is not supported for this operation.
	 */
	XRT_ERROR_UNSUPPORTED_SPACE_TYPE = -30,

	/*!
	 * Some other Android error, typically a logic error that should be impossible to reach.
	 */
	XRT_ERROR_ANDROID = -31,

	/*!
	 * Returned when a feature is not supported by the device.
	 */
	XRT_ERROR_FEATURE_NOT_SUPPORTED = -32,

	/*!
	 * The input provided is a valid value from the enum xrt_input_name but is not supported by the driver.
	 */
	XRT_ERROR_INPUT_UNSUPPORTED = -33,

	/*!
	 * The output provided is a valid value from the enum xrt_output_name but is not supported by the driver.
	 */
	XRT_ERROR_OUTPUT_UNSUPPORTED = -34,

	/*!
	 * The requested operation failed, verify the log to know more.
	 */
	XRT_ERROR_OUTPUT_REQUEST_FAILURE = -35,

	/*!
	 * Failed to create a sync primitive like mutex.
	 */
	XRT_ERROR_SYNC_PRIMITIVE_CREATION_FAILED = -36,

	/*!
	 * The IPC server detected that a service was already running and
	 * couldn't start because of that.
	 */
	XRT_ERROR_IPC_SERVICE_ALREADY_RUNNING = -37,

	/*!
	 * The IPC server couldn't starts it mainloop.
	 */
	XRT_ERROR_IPC_MAINLOOP_FAILED_TO_INIT = -38,

	/*!
	 * Invalid function arguments passed in, e.g. null or out-of-range values.
	 */
	XRT_ERROR_INVALID_ARGUMENT = -39,

	/*!
	 * Querying result of a future before it is ready.
	 */
	XRT_ERROR_FUTURE_RESULT_NOT_READY = -40,

	/*!
	 * Invoking complete on an already completed future
	 */
	XRT_ERROR_FUTURE_ALREADY_COMPLETE = -41,

	/*!
	 * The device's tracking origin is not of type
	 * XRT_TRACKING_TYPE_ATTACHABLE.
	 */
	XRT_ERROR_DEVICE_NOT_ATTACHABLE = -42,

	/*!
	 * C++ code threw an exception that wasn't caught.
	 */
	XRT_ERROR_UNCAUGHT_EXCEPTION = -43,

	/*!
	 * The specified @ref xrt_view_type was unsupported by the callee.
	 */
	XRT_ERROR_UNSUPPORTED_VIEW_TYPE = -44,
} xrt_result_t;
