feat(display): Configure display device based on user config (#3441)

src/audio.h

@@ -4,6 +4,8 @@
  */
 #pragma once
 
+// local includes
+#include "platform/common.h"
 #include "thread_safe.h"
 #include "utility.h"
 
@@ -55,8 +57,50 @@ namespace audio {
     std::bitset<MAX_FLAGS> flags;
   };
 
+  struct audio_ctx_t {
+    // We want to change the sink for the first stream only
+    std::unique_ptr<std::atomic_bool> sink_flag;
+
+    std::unique_ptr<platf::audio_control_t> control;
+
+    bool restore_sink;
+    platf::sink_t sink;
+  };
+
   using buffer_t = util::buffer_t<std::uint8_t>;
   using packet_t = std::pair<void *, buffer_t>;
+  using audio_ctx_ref_t = safe::shared_t<audio_ctx_t>::ptr_t;
+
   void
   capture(safe::mail_t mail, config_t config, void *channel_data);
+
+  /**
+   * @brief Get the reference to the audio context.
+   * @returns A shared pointer reference to audio context.
+   * @note Aside from the configuration purposes, it can be used to extend the
+   *       audio sink lifetime to capture sink earlier and restore it later.
+   *
+   * @examples
+   * audio_ctx_ref_t audio = get_audio_ctx_ref()
+   * @examples_end
+   */
+  audio_ctx_ref_t
+  get_audio_ctx_ref();
+
+  /**
+   * @brief Check if the audio sink held by audio context is available.
+   * @returns True if available (and can probably be restored), false otherwise.
+   * @note Useful for delaying the release of audio context shared pointer (which
+   *       tries to restore original sink).
+   *
+   * @examples
+   * audio_ctx_ref_t audio = get_audio_ctx_ref()
+   * if (audio.get()) {
+   *     return is_audio_ctx_sink_available(*audio.get());
+   * }
+   * return false;
+   * @examples_end
+   */
+  bool
+  is_audio_ctx_sink_available(const audio_ctx_t &ctx);
 }  // namespace audio