![]() |
VisionWorks Toolkit ReferenceDecember 18, 2015 | 1.2 Release |
Adds various extensions to vx_reference
.
This section describes different extensions and features to the standard Object: Reference.
This sections refines the description of a set of standard OpenVX functions with regards to the reference count management. For all other functions, see the OpenVX API Modules.
The following functions increment the reference counter of the returned object. The application must then explicitly release the returned reference by using the appropriate release function when it does not need this reference anymore.
vxGetPyramidLevel
vxGetParameterByIndex
vxGetKernelParameterByIndex
vxQueryParameter
with the VX_PARAMETER_ATTRIBUTE_REF
attribute Functions | |
vx_status | nvxReleaseReferenceList (vx_reference ref_list[], vx_size num_refs) |
Releases a list of references to OpenVX objects. More... | |
vx_status | nvxRetainReference (vx_reference ref) |
Increments the reference counter of an object. More... | |
vx_status nvxRetainReference | ( | vx_reference | ref | ) |
Increments the reference counter of an object.
Upon each call to this function for an object, an additional object release must be performed before the object is destroyed.
[in] | ref | The reference to retain. |
vx_status
enumerator. VX_SUCCESS | No errors. |
VX_ERROR_INVALID_REFERENCE | If the reference is not valid. |
vx_status nvxReleaseReferenceList | ( | vx_reference | ref_list[], |
vx_size | num_refs | ||
) |
Releases a list of references to OpenVX objects.
All references that are released without error are zeroed. If there were errors for some of the references in the list, the function returns the error status of the last failing reference release in the list.
[in] | ref_list | A pointer to the list of references to release. |
[in] | num_refs | The number of references in the list. |
vx_status
enumerator. VX_SUCCESS | No errors. |
VX_ERROR_INVALID_REFERENCE | If the reference is not valid. |