Image - Deprecated#
oneAPI Level Zero Specification - Version 1.20.41
Image - Deprecated Functions#
zeImageViewCreateExp#
Added in version 1.2
Deprecated since 1.5. Use zeImageViewCreateExt instead.
-
ZE_APIEXPORT ze_result_t ZE_APICALL zeImageViewCreateExp(ze_context_handle_t hContext, ze_device_handle_t hDevice, const ze_image_desc_t *desc, ze_image_handle_t hImage, ze_image_handle_t *phImageView)#
Create image view on the context.
The application must only use the image view for the device, or its sub-devices, which was provided during creation.
The application may call this function from simultaneous threads.
The implementation of this function must be thread-safe.
The implementation must support ZE_IMAGE_VIEW_EXP_NAME extension.
Image views are treated as images from the API.
Image views provide a mechanism to redescribe how an image is interpreted (e.g. different format).
Image views become disabled when their corresponding image resource is destroyed.
Use zeImageDestroy to destroy image view objects.
Remark
Analogues
None
- Parameters:
hContext – [in] handle of the context object
hDevice – [in] handle of the device
desc – [in] pointer to image descriptor
hImage – [in] handle of image object to create view from
phImageView – [out] pointer to handle of image object created for view
- Returns:
ZE_RESULT_ERROR_INVALID_NULL_HANDLE
nullptr == hContextnullptr == hDevicenullptr == hImage
ZE_RESULT_ERROR_INVALID_NULL_POINTER
nullptr == descnullptr == phImageView
ZE_RESULT_ERROR_INVALID_ENUMERATION
0x3 < desc->flagsZE_IMAGE_TYPE_BUFFER < desc->type
Image - Deprecated Structures#
ze_image_view_planar_exp_desc_t#
Added in version 1.2
Deprecated since 1.5. Use ze_image_view_planar_ext_desc_t instead.
-
struct ze_image_view_planar_exp_desc_t#
Image view planar descriptor
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 planeIndex#
[in] the 0-based plane index (e.g. NV12 is 0 = Y plane, 1 UV plane)
-
ze_structure_type_t stype#