IREE HAL target-routing options. More...

#include <iree_hal.h>

Data Fields
loomc_structure_type_t	type
	Structure type.
loomc_host_size_t	structure_size
	Size of this structure in bytes.
const void *	next
	Provider-specific option descriptors.
loomc_string_view_t	identifier
	Stable identifier for a profile derived from the device.
iree_hal_device_t *	device
	IREE HAL device borrowed for the duration of the call.
iree_hal_queue_t *	queue
	Optional dispatch queue borrowed for the duration of the call.
iree_hal_physical_device_affinity_t	physical_device_affinity
	Optional physical-device set the selected target must fully cover.
loomc_target_profile_t *	target_profile
	Optional caller-selected compiler profile to bind to this HAL device.
const loomc_iree_hal_target_provider_t const	providers
	Ordered borrowed array of provider descriptors.
loomc_host_size_t	provider_count
	Number of entries in providers.

Detailed Description

IREE HAL target-routing options.

Field Documentation

◆ physical_device_affinity

iree_hal_physical_device_affinity_t loomc_iree_hal_target_options_t::physical_device_affinity

Optional physical-device set the selected target must fully cover.

Zero selects the unique highest-priority target for the logical device. A heterogeneous logical device may require an explicit affinity. With queue, zero uses the queue affinity and nonzero must equal it.

◆ queue

iree_hal_queue_t* loomc_iree_hal_target_options_t::queue

Optional dispatch queue borrowed for the duration of the call.

When supplied, selection uses its physical-device affinity and retains its available execution-unit count in the profile when known. The queue must belong to device; no queue reference is retained by the result.

◆ target_profile

loomc_target_profile_t* loomc_iree_hal_target_options_t::target_profile

Optional caller-selected compiler profile to bind to this HAL device.

When NULL, the selected provider derives the best compatible profile from immutable device facts. When non-NULL, the provider validates the profile against those facts and returns the compatible profile that compilation must use. A provider may enrich a static profile with device facts while preserving its exact compiler choice.

◆ type

loomc_structure_type_t loomc_iree_hal_target_options_t::type

Structure type.

Must be LOOMC_STRUCTURE_TYPE_IREE_HAL_TARGET_OPTIONS when nonzero.

The documentation for this struct was generated from the following file:

iree_hal.h