NVIDIA DRIVE OS Linux SDK API Reference5.1.9.0 Release |
Methods to perform operations on NvSciBuf attribute lists.
Functions | |
NvSciError | NvSciBufAttrListCreate (NvSciBufModule module, NvSciBufAttrList *newAttrList) |
Creates an attribute list holding the attributes of the NvSciBufObj to be allocated. More... | |
void | NvSciBufAttrListFree (NvSciBufAttrList attrList) |
Frees the memory of an attribute list. More... | |
NvSciError | NvSciBufAttrListSetAttrs (NvSciBufAttrList attrList, NvSciBufAttrKeyValuePair *pairArray, size_t pairCount) |
Sets the attribute values in the attribute list. More... | |
size_t | NvSciBufAttrListGetSlotCount (NvSciBufAttrList attrList) |
Returns the slot count per key in an attribute list. More... | |
NvSciError | NvSciBufAttrListGetAttrs (NvSciBufAttrList attrList, NvSciBufAttrKeyValuePair *pairArray, size_t pairCount) |
Returns an array of attribute key/value pairs for a given set of keys. More... | |
NvSciError | NvSciBufAttrListSlotGetAttrs (NvSciBufAttrList attrList, size_t slotIndex, NvSciBufAttrKeyValuePair *pairArray, size_t pairCount) |
Returns an array of attribute key/value pairs from a multi-slot unreconciled attribute list at the given slot index. More... | |
NvSciError | NvSciBufAttrListDebugDump (NvSciBufAttrList attrList, void **buf, size_t *len) |
Allocates a buffer and then dumps the contents of the specified attribute list into the buffer. More... | |
NvSciError | NvSciBufAttrListReconcile (NvSciBufAttrList inputArray[], size_t inputCount, NvSciBufAttrList *newReconciledAttrList, NvSciBufAttrList *newConflictList) |
Reconciles the given unreconciled attribute list(s) into a new reconciled attribute list. More... | |
NvSciError | NvSciBufAttrListClone (NvSciBufAttrList origAttrList, NvSciBufAttrList *newAttrList) |
Clones an unreconciled/reconciled attribute list. More... | |
NvSciError | NvSciBufAttrListAppendUnreconciled (const NvSciBufAttrList inputUnreconciledAttrListArray[], size_t inputUnreconciledAttrListCount, NvSciBufAttrList *newUnreconciledAttrList) |
Append multiple unreconciled attribute lists together, forming a single new unreconciled attribute list with a slot count equal to the sum of all the slot counts in the input list. More... | |
NvSciError | NvSciBufAttrListIsReconciled (NvSciBufAttrList attrList, bool *isReconciled) |
Checks if an attribute list is reconciled. More... | |
NvSciError | NvSciBufAttrListValidateReconciled (NvSciBufAttrList reconciledAttrList, const NvSciBufAttrList unreconciledAttrListArray[], size_t unreconciledAttrListCount, bool *isReconcileListValid) |
Validates a reconciled attribute list against a set of unreconciled attribute lists. More... | |
NvSciError NvSciBufAttrListAppendUnreconciled | ( | const NvSciBufAttrList | inputUnreconciledAttrListArray[], |
size_t | inputUnreconciledAttrListCount, | ||
NvSciBufAttrList * | newUnreconciledAttrList | ||
) |
Append multiple unreconciled attribute lists together, forming a single new unreconciled attribute list with a slot count equal to the sum of all the slot counts in the input list.
[in] | inputUnreconciledAttrListArray[] | Array containing the unreconciled attribute lists to be appended together. |
[in] | inputUnreconciledAttrListCount | Number of unreconciled attribute lists to append. |
[out] | newUnreconciledAttrList | Appended attribute list created out of the input unreconciled attribute lists. |
NvSciError NvSciBufAttrListClone | ( | NvSciBufAttrList | origAttrList, |
NvSciBufAttrList * | newAttrList | ||
) |
Clones an unreconciled/reconciled attribute list.
The resulting attribute list contains all the values of the original attribute list. If the list is an unreconciled attribute list, then modification will be allowed using setAttrList APIs.
[in] | origAttrList | Attribute list to be cloned. |
[out] | newAttrList | A pointer to the newly cloned attribute list. |
NvSciError NvSciBufAttrListCreate | ( | NvSciBufModule | module, |
NvSciBufAttrList * | newAttrList | ||
) |
Creates an attribute list holding the attributes of the NvSciBufObj to be allocated.
[in] | module | NvSciBufModule to associate with the newly created NvSciBufAttrList. |
[out] | newAttrList | A pointer to the NvSciBufAttrList object that this function creates. |
NvSciError NvSciBufAttrListDebugDump | ( | NvSciBufAttrList | attrList, |
void ** | buf, | ||
size_t * | len | ||
) |
Allocates a buffer and then dumps the contents of the specified attribute list into the buffer.
[in] | attrList | Attribute list to fetch contents from. |
[out] | buf | A pointer to the buffer allocated for the debug dump. |
[out] | len | The length of the buffer allocated for the debug dump. |
void NvSciBufAttrListFree | ( | NvSciBufAttrList | attrList | ) |
Frees the memory of an attribute list.
[in] | attrList | Attribute list to be freed. |
NvSciError NvSciBufAttrListGetAttrs | ( | NvSciBufAttrList | attrList, |
NvSciBufAttrKeyValuePair * | pairArray, | ||
size_t | pairCount | ||
) |
Returns an array of attribute key/value pairs for a given set of keys.
This function accepts a set of keys passed in the NvSciBufAttrKeyValuePair structure. The return values, stored back into NvSciBufAttrKeyValuePair, consist of const
void*
pointers to the attribute values from the NvSciBufAttrList. The application must not write to this data.
[in] | attrList | Attribute list to fetch the attribute key/value pairs from. |
[in,out] | pairArray | Array of key/value pair structures. |
[in] | pairCount | Number of elements/entries in pairArray. |
size_t NvSciBufAttrListGetSlotCount | ( | NvSciBufAttrList | attrList | ) |
Returns the slot count per key in an attribute list.
[in] | attrList | Attribute list to retrieve the slot count from. |
NvSciError NvSciBufAttrListIsReconciled | ( | NvSciBufAttrList | attrList, |
bool * | isReconciled | ||
) |
Checks if an attribute list is reconciled.
[in] | attrList | Attribute list to check. |
[out] | isReconciled | A pointer to a boolean to store whether the attrlist is reconciled or not. |
NvSciError NvSciBufAttrListReconcile | ( | NvSciBufAttrList | inputArray[], |
size_t | inputCount, | ||
NvSciBufAttrList * | newReconciledAttrList, | ||
NvSciBufAttrList * | newConflictList | ||
) |
Reconciles the given unreconciled attribute list(s) into a new reconciled attribute list.
On success, this API call allocates memory for the reconciled attribute list which has to be freed by the caller using NvSciBufAttrListFree(). On reconciliation failure, this API call allocates memory for the conflicting attribute list which has to be freed by the caller using NvSciBufAttrListFree().
[in] | inputArray | Array containing unreconciled attribute list(s) to be reconciled. |
[in] | inputCount | The number of unreconciled attributes lists in inputArray. |
[out] | newReconciledAttrList | Reconciled attribute list. This field is populated only if the reconciliation succeeded. |
[out] | newConflictList | Unreconciled attribute list consisting of the key/value pairs which caused the reconciliation failure. This field is populated only if the reconciliation failed. |
NvSciError NvSciBufAttrListSetAttrs | ( | NvSciBufAttrList | attrList, |
NvSciBufAttrKeyValuePair * | pairArray, | ||
size_t | pairCount | ||
) |
Sets the attribute values in the attribute list.
Reads values only during the call, saving copies.
[in] | attrList | Unreconciled attribute list where the function will set the attribute key and value. |
[in] | pairArray | Array of attribute key/value pair structures. |
[in] | pairCount | Number of elements/entries in pairArray. |
NvSciError NvSciBufAttrListSlotGetAttrs | ( | NvSciBufAttrList | attrList, |
size_t | slotIndex, | ||
NvSciBufAttrKeyValuePair * | pairArray, | ||
size_t | pairCount | ||
) |
Returns an array of attribute key/value pairs from a multi-slot unreconciled attribute list at the given slot index.
The return values, stored in NvSciBufAttrKeyValuePair, consist of const
void*
pointers to the attribute values from the NvSciBufAttrList. The application must not write to this data.
[in] | attrList | Attribute list to fetch the attribute key/value pairs from. |
[in] | slotIndex | Index in the attribute list. |
[in,out] | pairArray | Array of key/value pair structures. Holds the keys passed into the function and returns an array of NvSciBufAttrKeyValuePair structures. |
[in] | pairCount | Number of elements/entries in pairArray. |
NvSciError NvSciBufAttrListValidateReconciled | ( | NvSciBufAttrList | reconciledAttrList, |
const NvSciBufAttrList | unreconciledAttrListArray[], | ||
size_t | unreconciledAttrListCount, | ||
bool * | isReconcileListValid | ||
) |
Validates a reconciled attribute list against a set of unreconciled attribute lists.
[in] | reconciledAttrList | Reconciled attribute list to be validated. |
[in] | unreconciledAttrListArray | Set of unreconciled lists that need to be used for validation. |
[in] | unreconciledAttrListCount | Number of unreconciled attribute lists. |
[out] | isReconcileListValid | Flag indicating if the reconciled list satisfies the parameters of set of unreconciled lists. |