nvflinger: Mark interface functions with return values as [[nodiscard]]
Not using the return value of these functions are undeniably the source of a bug. This way we allow compilers to loudly make any future misuses evident.
This commit is contained in:
parent
5dab23e017
commit
7b070bbf62
|
@ -54,12 +54,12 @@ public:
|
||||||
/// Opens the specified display and returns the ID.
|
/// Opens the specified display and returns the ID.
|
||||||
///
|
///
|
||||||
/// If an invalid display name is provided, then an empty optional is returned.
|
/// If an invalid display name is provided, then an empty optional is returned.
|
||||||
std::optional<u64> OpenDisplay(std::string_view name);
|
[[nodiscard]] std::optional<u64> OpenDisplay(std::string_view name);
|
||||||
|
|
||||||
/// Creates a layer on the specified display and returns the layer ID.
|
/// Creates a layer on the specified display and returns the layer ID.
|
||||||
///
|
///
|
||||||
/// If an invalid display ID is specified, then an empty optional is returned.
|
/// If an invalid display ID is specified, then an empty optional is returned.
|
||||||
std::optional<u64> CreateLayer(u64 display_id);
|
[[nodiscard]] std::optional<u64> CreateLayer(u64 display_id);
|
||||||
|
|
||||||
/// Closes a layer on all displays for the given layer ID.
|
/// Closes a layer on all displays for the given layer ID.
|
||||||
void CloseLayer(u64 layer_id);
|
void CloseLayer(u64 layer_id);
|
||||||
|
@ -67,41 +67,39 @@ public:
|
||||||
/// Finds the buffer queue ID of the specified layer in the specified display.
|
/// Finds the buffer queue ID of the specified layer in the specified display.
|
||||||
///
|
///
|
||||||
/// If an invalid display ID or layer ID is provided, then an empty optional is returned.
|
/// If an invalid display ID or layer ID is provided, then an empty optional is returned.
|
||||||
std::optional<u32> FindBufferQueueId(u64 display_id, u64 layer_id) const;
|
[[nodiscard]] std::optional<u32> FindBufferQueueId(u64 display_id, u64 layer_id) const;
|
||||||
|
|
||||||
/// Gets the vsync event for the specified display.
|
/// Gets the vsync event for the specified display.
|
||||||
///
|
///
|
||||||
/// If an invalid display ID is provided, then nullptr is returned.
|
/// If an invalid display ID is provided, then nullptr is returned.
|
||||||
std::shared_ptr<Kernel::ReadableEvent> FindVsyncEvent(u64 display_id) const;
|
[[nodiscard]] std::shared_ptr<Kernel::ReadableEvent> FindVsyncEvent(u64 display_id) const;
|
||||||
|
|
||||||
/// Obtains a buffer queue identified by the ID.
|
/// Obtains a buffer queue identified by the ID.
|
||||||
BufferQueue& FindBufferQueue(u32 id);
|
[[nodiscard]] BufferQueue& FindBufferQueue(u32 id);
|
||||||
|
|
||||||
/// Obtains a buffer queue identified by the ID.
|
/// Obtains a buffer queue identified by the ID.
|
||||||
const BufferQueue& FindBufferQueue(u32 id) const;
|
[[nodiscard]] const BufferQueue& FindBufferQueue(u32 id) const;
|
||||||
|
|
||||||
/// Performs a composition request to the emulated nvidia GPU and triggers the vsync events when
|
/// Performs a composition request to the emulated nvidia GPU and triggers the vsync events when
|
||||||
/// finished.
|
/// finished.
|
||||||
void Compose();
|
void Compose();
|
||||||
|
|
||||||
s64 GetNextTicks() const;
|
[[nodiscard]] s64 GetNextTicks() const;
|
||||||
|
|
||||||
std::unique_lock<std::mutex> Lock() const {
|
[[nodiscard]] std::unique_lock<std::mutex> Lock() const { return std::unique_lock{*guard}; }
|
||||||
return std::unique_lock{*guard};
|
|
||||||
}
|
|
||||||
|
|
||||||
private:
|
private :
|
||||||
/// Finds the display identified by the specified ID.
|
/// Finds the display identified by the specified ID.
|
||||||
VI::Display* FindDisplay(u64 display_id);
|
[[nodiscard]] VI::Display* FindDisplay(u64 display_id);
|
||||||
|
|
||||||
/// Finds the display identified by the specified ID.
|
/// Finds the display identified by the specified ID.
|
||||||
const VI::Display* FindDisplay(u64 display_id) const;
|
[[nodiscard]] const VI::Display* FindDisplay(u64 display_id) const;
|
||||||
|
|
||||||
/// Finds the layer identified by the specified ID in the desired display.
|
/// Finds the layer identified by the specified ID in the desired display.
|
||||||
VI::Layer* FindLayer(u64 display_id, u64 layer_id);
|
[[nodiscard]] VI::Layer* FindLayer(u64 display_id, u64 layer_id);
|
||||||
|
|
||||||
/// Finds the layer identified by the specified ID in the desired display.
|
/// Finds the layer identified by the specified ID in the desired display.
|
||||||
const VI::Layer* FindLayer(u64 display_id, u64 layer_id) const;
|
[[nodiscard]] const VI::Layer* FindLayer(u64 display_id, u64 layer_id) const;
|
||||||
|
|
||||||
static void VSyncThread(NVFlinger& nv_flinger);
|
static void VSyncThread(NVFlinger& nv_flinger);
|
||||||
|
|
||||||
|
|
Reference in New Issue