Device - Experimental#
oneAPI Level Zero Specification - Version 1.18.31
Device - Experimental Functions#
zeDeviceGetFabricVertexExp#
Added in version 1.4
-
ZE_APIEXPORT ze_result_t ZE_APICALL zeDeviceGetFabricVertexExp(ze_device_handle_t hDevice, ze_fabric_vertex_handle_t *phVertex)#
Returns fabric vertex handle from device handle.
The application may call this function from simultaneous threads.
The implementation of this function should be lock-free.
- Parameters:
hDevice – [in] handle of the device
phVertex – [out] fabric vertex handle corresponding to device
- Returns:
ZE_RESULT_ERROR_INVALID_NULL_HANDLE
nullptr == hDevice
ZE_RESULT_ERROR_INVALID_NULL_POINTER
nullptr == phVertex
ZE_RESULT_EXP_ERROR_DEVICE_IS_NOT_VERTEX
Provided device handle does not correspond to a fabric vertex.
Device - Experimental Enums#
ze_rtas_device_exp_flags_t#
Added in version 1.7
ze_rtas_format_exp_t#
Added in version 1.7
-
enum ze_rtas_format_exp_t#
Ray tracing acceleration structure format.
This is an opaque ray tracing acceleration structure format identifier.
Values:
-
enumerator ZE_RTAS_FORMAT_EXP_INVALID#
Invalid acceleration structure format.
-
enumerator ZE_RTAS_FORMAT_EXP_MAX#
Maximum acceleration structure format code. (since v1.13)
-
enumerator ZE_RTAS_FORMAT_EXP_FORCE_UINT32#
Value marking end of ZE_RTAS_FORMAT_EXP_* ENUMs.
Device - Experimental Structures#
ze_scheduling_hint_exp_properties_t#
Added in version 1.2
-
struct ze_scheduling_hint_exp_properties_t#
Device kernel scheduling hint properties queried using zeDeviceGetModuleProperties.
This structure may be returned from zeDeviceGetModuleProperties, via the
pNextmember 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_scheduling_hint_exp_flags_t schedulingHintFlags#
[out] Supported kernel scheduling hints. May be 0 (none) or a valid combination of ze_scheduling_hint_exp_flag_t.
ze_device_p2p_bandwidth_exp_properties_t#
Added in version 1.4
-
struct ze_device_p2p_bandwidth_exp_properties_t#
P2P Bandwidth Properties.
This structure may be passed to zeDeviceGetP2PProperties by having the pNext member of ze_device_p2p_properties_t point at this struct.
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).
-
uint32_t logicalBandwidth#
[out] total logical design bandwidth for all links connecting the two devices
-
uint32_t physicalBandwidth#
[out] total physical design bandwidth for all links connecting the two devices
-
ze_bandwidth_unit_t bandwidthUnit#
[out] bandwidth unit
-
uint32_t logicalLatency#
[out] average logical design latency for all links connecting the two devices
-
uint32_t physicalLatency#
[out] average physical design latency for all links connecting the two devices
-
ze_latency_unit_t latencyUnit#
[out] latency unit
ze_rtas_device_exp_properties_t#
Added in version 1.7
-
struct ze_rtas_device_exp_properties_t#
Ray tracing acceleration structure device properties.
This structure may be passed to zeDeviceGetProperties, via
pNextmember of ze_device_properties_t.The implementation shall populate
formatwith a value other than ZE_RTAS_FORMAT_EXP_INVALID when the device supports ray tracing.
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_rtas_device_exp_flags_t flags#
[out] ray tracing acceleration structure device flags
-
ze_rtas_format_exp_t rtasFormat#
[out] ray tracing acceleration structure format
-
uint32_t rtasBufferAlignment#
[out] required alignment of acceleration structure buffer
ze_device_pitched_alloc_exp_properties_t#
Added in version 1.9
-
struct ze_device_pitched_alloc_exp_properties_t#
Device specific properties for pitched allocations.
This structure may be passed to zeDeviceGetImageProperties via the pNext member of ze_device_image_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).
-
size_t maxImageLinearWidth#
[out] Maximum image linear width.
-
size_t maxImageLinearHeight#
[out] Maximum image linear height.
ze_pitched_alloc_2dimage_linear_pitch_exp_info_t#
Added in version 1.14
-
struct ze_pitched_alloc_2dimage_linear_pitch_exp_info_t#
Pitch information for 2-dimensional linear pitched allocations.
This structure may be passed to zeDeviceGetImageProperties in conjunction with the ze_device_pitched_alloc_exp_properties_t via its pNext member
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).
-
size_t pitchAlign#
[out] Required pitch Alignment in Bytes.
-
size_t maxSupportedPitch#
[out] Maximum allowed pitch in Bytes.
ze_custom_pitch_exp_desc_t#
Added in version 1.15
-
struct ze_custom_pitch_exp_desc_t#
Specify user defined pitch for pitched linear image allocations. This structure may be passed to zeImageCreate in conjunction with ze_image_pitched_exp_desc_t via its pNext member.
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).
-
size_t rowPitch#
[in] user programmed aligned pitch for pitched linear image allocations. This pitch should satisfy the pitchAlign requirement in ze_pitched_alloc_2dimage_linear_pitch_exp_info_t
-
size_t slicePitch#
[in] user programmed slice pitch , must be multiple of rowPitch. For 2D image array or a slice of a 3D image array - this pitch should be >= rowPitch * image_height . For 1D image array >= rowPitch.
-
ze_structure_type_t stype#