Context - Extensions

oneAPI Level Zero Specification - Version 1.18.31

Context - Extension Enums

ze_device_raytracing_ext_flags_t

Added in version 1.0

enum ze_device_raytracing_ext_flag_t

Values:

enumerator ZE_DEVICE_RAYTRACING_EXT_FLAG_RAYQUERY

Supports rayquery.

enumerator ZE_DEVICE_RAYTRACING_EXT_FLAG_FORCE_UINT32

Value marking end of ZE_DEVICE_RAYTRACING_EXT_FLAG_* ENUMs.

ze_raytracing_mem_alloc_ext_flags_t

Added in version 1.0

enum ze_raytracing_mem_alloc_ext_flag_t

Values:

enumerator ZE_RAYTRACING_MEM_ALLOC_EXT_FLAG_TBD

reserved for future use

enumerator ZE_RAYTRACING_MEM_ALLOC_EXT_FLAG_FORCE_UINT32

Value marking end of ZE_RAYTRACING_MEM_ALLOC_EXT_FLAG_* ENUMs.

ze_power_saving_hint_ext_type_t

Added in version 1.18

enum ze_power_saving_hint_ext_type_t

Supported device types.

Values:

enumerator ZE_POWER_SAVING_HINT_EXT_TYPE_MIN

Minimum power savings. The device will make no attempt to save power while executing work submitted to this context.

enumerator ZE_POWER_SAVING_HINT_EXT_TYPE_MAX

Maximum power savings. The device will do everything to bring power to a minimum while executing work submitted to this context.

enumerator ZE_POWER_SAVING_HINT_EXT_TYPE_FORCE_UINT32

Value marking end of ZE_POWER_SAVING_HINT_EXT_TYPE_* ENUMs.

Context - Extension Structures

ze_device_raytracing_ext_properties_t

Added in version 1.0

struct ze_device_raytracing_ext_properties_t

Raytracing properties queried using zeDeviceGetModuleProperties.

• This structure may be returned from zeDeviceGetModuleProperties, via the pNext member of ze_device_module_properties_t.

Public Members

ze_structure_type_t stype

[in] type of this structure

void *pNext

[in,out][optional] must be null or a pointer to an extension-specific structure (i.e. contains stype and pNext).

ze_device_raytracing_ext_flags_t flags

[out] 0 or a valid combination of ze_device_raytracing_ext_flags_t

uint32_t maxBVHLevels

[out] Maximum number of BVH levels supported

ze_raytracing_mem_alloc_ext_desc_t

Added in version 1.0

struct ze_raytracing_mem_alloc_ext_desc_t

Raytracing memory allocation descriptor.

• This structure must be passed to zeMemAllocShared or zeMemAllocDevice, via the pNext member of ze_device_mem_alloc_desc_t, for any memory allocation that is to be accessed by raytracing fixed-function of the device.

Public Members

ze_structure_type_t stype

[in] type of this structure

const void *pNext

[in][optional] must be null or a pointer to an extension-specific structure (i.e. contains stype and pNext).

ze_raytracing_mem_alloc_ext_flags_t flags

[in] flags specifying additional allocation controls. must be 0 (default) or a valid combination of ze_raytracing_mem_alloc_ext_flag_t; default behavior may use implicit driver-based heuristics.

ze_context_power_saving_hint_ext_desc_t

Added in version 1.18

struct ze_context_power_saving_hint_ext_desc_t

Extended context descriptor containing power saving hint.

Public Members

ze_structure_type_t stype

[in] type of this structure

const void *pNext

[in][optional] must be null or a pointer to an extension-specific structure (i.e. contains stype and pNext).

uint32_t hint

[in] power saving hint (default value = 0). This is value from [0,100] and can use pre-defined settings from ze_power_saving_hint_ext_type_t.