holoscan::ThreadPlacement

Beta

Describe one complete deployment-time thread placement request.

This owning value contains only requested policy. Compilation validates the value and may use a read-only platform probe to freeze separate requested and accepted plan records. Constructing or validating this value never changes the calling thread. The value is not thread-safe for concurrent mutation; immutable copies may be read concurrently.

#include <holoscan/thread_placement.hpp>

Methods

validate

HOLOSCAN_CORE_EXPORT expected<void, Error> holoscan::ThreadPlacement::validate() const

Validate every closed placement field without probing or applying it.

This method performs no OS query and does not mutate thread state.

Returns: An empty result on success, or ErrorCode::kInvalidArgument for an empty present affinity, invalid scheduling tuple, or unknown closed enum value.

Throws: Nothing. Allocation failures are not possible in this validation.

Member variables

Name	Type	Description
`affinity`	`std::optional< CPUAffinity >`	Requested CPU set; absence leaves affinity unchanged.
`scheduling`	`ThreadScheduling`	Requested scheduler policy and policy-specific fields.
`wake_mode`	`WakeMode`	Runtime readiness-wait strategy.
`irq_isolation`	`IRQIsolation`	Requested isolation evidence.
`probe_failure_policy`	`ProbeFailurePolicy`	Missing-proof admission behavior.