oxr_suggested_profile_array.c File Reference

Holds suggested profile array related functions. More...

#include "util/u_misc.h"
#include "oxr_suggested_profile_array.h"
#include "oxr_binding_profile.h"
#include "oxr_binding_registry.h"
#include "oxr_rebinding_profile.h"

Include dependency graph for oxr_suggested_profile_array.c:

Functions
void	oxr_suggested_profile_array_clear (struct oxr_suggested_profile_array *array)
void	oxr_suggested_profile_array_add (struct oxr_suggested_profile_array *array, struct oxr_suggested_profile *profile)
XrResult	oxr_suggested_profile_array_clone (const struct oxr_suggested_profile_array *src, struct oxr_suggested_profile_array *dst)
bool	oxr_suggested_profile_array_find_by_path (const struct oxr_suggested_profile_array *array, XrPath path, struct oxr_suggested_profile **out_p)
bool	oxr_suggested_profile_array_find_by_device_name (const struct oxr_suggested_profile_array *array, enum xrt_device_name name, struct oxr_suggested_profile **out_p)
	Find a suggested profile by the XRT device name stored on its profile template.
bool	oxr_suggested_profile_array_find_rebinding_for_device_name (const struct oxr_suggested_profile_array *array, const struct oxr_binding_registry *registry, enum xrt_device_name target_device_name, struct oxr_suggested_profile **out_p, const struct oxr_rebinding_profile **out_rebinding)
	Find the first rebinding profile that targets target_device_name and has a suggested source profile in array.

Detailed Description

Holds suggested profile array related functions.

Author

Jakob Bornecrantz jakob.nosp@m.@col.nosp@m.labor.nosp@m.a.co.nosp@m.m

Korcan Hussein korca.nosp@m.n.hu.nosp@m.ssein.nosp@m.@col.nosp@m.labor.nosp@m.a.co.nosp@m.m

Function Documentation

oxr_suggested_profile_array_find_by_device_name()

bool oxr_suggested_profile_array_find_by_device_name	(	const struct oxr_suggested_profile_array *	array,
		enum xrt_device_name	name,
		struct oxr_suggested_profile **	out_p
	)

Find a suggested profile by the XRT device name stored on its profile template.

This directly compares name against each suggested profile's generated template.

Parameters

	array	Suggested profile array to search, must not be NULL
	name	XRT device name stored on the profile template
[out]	out_p	Found suggested profile; NULL if not found. Must not be NULL.

Returns

true if a matching profile was found, false otherwise

References oxr_suggested_profile::templ.

oxr_suggested_profile_array_find_rebinding_for_device_name()

bool oxr_suggested_profile_array_find_rebinding_for_device_name	(	const struct oxr_suggested_profile_array *	array,
		const struct oxr_binding_registry *	registry,
		enum xrt_device_name	target_device_name,
		struct oxr_suggested_profile **	out_p,
		const struct oxr_rebinding_profile **	out_rebinding
	)

Find the first rebinding profile that targets target_device_name and has a suggested source profile in array.

The helper walks the registry's generated rebinding profiles in registry order. This lets template generation decide priority: higher-priority rebindings, such as generic controller rebindings, should be emitted earlier. For each matching rebinding target device, the helper looks for a suggested profile with the rebinding source profile path.

Parameters

	array	Suggested profile array to search, must not be NULL
	registry	Binding registry whose rebinding profiles are walked, must not be NULL
	target_device_name	Device name the rebinding profile must target
[out]	out_p	Suggested source profile, or NULL if not found
[out]	out_rebinding	Matching rebinding profile, or NULL if not found

Returns

true if a matching rebinding and suggested profile were found

References oxr_binding_profile::device_name, oxr_binding_registry::rebindings, oxr_binding_profile::registry, oxr_rebinding_profile::source_profile_path, and oxr_rebinding_profile::target_profile_path.