NVIDIA DRIVE OS Linux SDK API Reference
6.0.9 Release
Public Member Functions | Protected Member Functions
nvsipl::INvSIPLClient::INvSIPLBuffer Class Referenceabstract

Detailed Description

Abstract interface for SIPL buffers.

Definition at line 127 of file NvSIPLClient.hpp.

Inheritance diagram for nvsipl::INvSIPLClient::INvSIPLBuffer:
Inheritance graph
[legend]

Public Member Functions

virtual void AddRef ()=0
 Adds a reference. More...
 
virtual SIPLStatus Release ()=0
 Release a reference. More...
 
virtual SIPLStatus AddNvSciSyncPrefence (const NvSciSyncFence &prefence)=0
 Add an NvSciSync prefence. More...
 
virtual SIPLStatus GetEOFNvSciSyncFence (NvSciSyncFence *const postfence)=0
 Retrieve the latest NvSciSync EOF fence. More...
 
virtual ~INvSIPLBuffer ()=default
 
 INvSIPLBuffer (INvSIPLBuffer &other)=delete
 
INvSIPLBuffer & operator= (INvSIPLBuffer &other) &=delete
 
 INvSIPLBuffer (INvSIPLBuffer &&other)=delete
 
INvSIPLBuffer & operator= (INvSIPLBuffer &&other) &=delete
 

Protected Member Functions

 INvSIPLBuffer ()=default
 

Constructor & Destructor Documentation

◆ ~INvSIPLBuffer()

virtual nvsipl::INvSIPLClient::INvSIPLBuffer::~INvSIPLBuffer ( )
virtualdefault

◆ INvSIPLBuffer() [1/3]

nvsipl::INvSIPLClient::INvSIPLBuffer::INvSIPLBuffer ( INvSIPLBuffer &  other)
delete

◆ INvSIPLBuffer() [2/3]

nvsipl::INvSIPLClient::INvSIPLBuffer::INvSIPLBuffer ( INvSIPLBuffer &&  other)
delete

◆ INvSIPLBuffer() [3/3]

nvsipl::INvSIPLClient::INvSIPLBuffer::INvSIPLBuffer ( )
protecteddefault

Member Function Documentation

◆ AddNvSciSyncPrefence()

virtual SIPLStatus nvsipl::INvSIPLClient::INvSIPLBuffer::AddNvSciSyncPrefence ( const NvSciSyncFence &  prefence)
pure virtual

Add an NvSciSync prefence.

Add an NvSciSync prefence to be used with the next ISP or ICP operation. This function creates its own duplicate of the fence, so the caller must clear their copy of the fence by calling NvSciSyncFenceClear().

ICP operations support up to 3 unique pre-fences per pipeline ISP operations support up to 8 unique pre-fences per pipeline

Users need to ensure that the number of unique pre-fences for ISP does not exceed 8 across the all output buffers if using more than one ISP outputs for the pipeline.

Precondition
None.
Parameters
[in]prefencePrefence to be added.

AddNvSciSyncPrefence() originates the following SIPLStatus return values:

Return values
NVSIPL_STATUS_OKThe function succeeds.
NVSIPL_STATUS_ERRORIf internal NvSci fence operations fail.
SIPLStatusOther values of SIPLStatus are propagated.


Usage considerations

  • Allowed context for the API call
    • Interrupt handler: No
    • Signal handler: No
    • Thread-safe: Yes
    • Re-entrant: No
    • Async/Sync: Sync
  • Required privileges: Yes, with the following conditions:
    • Grants: nonroot, allow
    • Abilities: public_channel
    • Application needs to have access to the SGIDs that SIPL depends on as mentioned in the NVIDIA DRIVE OS Safety Developer Guide
  • API group
    • Init: No
    • Runtime: Yes
    • De-Init: No

◆ AddRef()

virtual void nvsipl::INvSIPLClient::INvSIPLBuffer::AddRef ( )
pure virtual

Adds a reference.

Adding a reference to the buffer ensures that this buffer is not re-used by the producer of the buffer.

Precondition
None.


Usage considerations

  • Allowed context for the API call
    • Interrupt handler: No
    • Signal handler: No
    • Thread-safe: Yes, with the following conditions:
      • There is no active release operation that results in the buffer available for re-use.
    • Re-entrant: No
    • Async/Sync: Sync
  • Required privileges: Yes, with the following conditions:
    • Grants: nonroot, allow
    • Abilities: public_channel
    • Application needs to have access to the SGIDs that SIPL depends on as mentioned in the NVIDIA DRIVE OS Safety Developer Guide
  • API group
    • Init: No
    • Runtime: Yes
    • De-Init: No

◆ GetEOFNvSciSyncFence()

virtual SIPLStatus nvsipl::INvSIPLClient::INvSIPLBuffer::GetEOFNvSciSyncFence ( NvSciSyncFence *const  postfence)
pure virtual

Retrieve the latest NvSciSync EOF fence.

Retrieve the buffer's latest NvSciSync EOF fence associated with the engine's set NvSciSync EOF object. The caller must clear the returned fence by calling NvSciSyncFenceClear().

Precondition
None.
Parameters
[out]postfenceEOF fence being returned.

GetEOFNvSciSyncFence() originates the following SIPLStatus return values:

Return values
NVSIPL_STATUS_OKThe function succeeds.
NVSIPL_STATUS_ERRORIf internal NvSci fence operations fail.
SIPLStatusOther values of SIPLStatus are propagated.


Usage considerations

  • Allowed context for the API call
    • Interrupt handler: No
    • Signal handler: No
    • Thread-safe: Yes
    • Re-entrant: Yes
    • Async/Sync: Sync
  • Required privileges: Yes, with the following conditions:
    • Grants: nonroot, allow
    • Abilities: public_channel
    • Application needs to have access to the SGIDs that SIPL depends on as mentioned in the NVIDIA DRIVE OS Safety Developer Guide
  • API group
    • Init: No
    • Runtime: Yes
    • De-Init: No

◆ operator=() [1/2]

INvSIPLBuffer& nvsipl::INvSIPLClient::INvSIPLBuffer::operator= ( INvSIPLBuffer &&  other) &
delete

◆ operator=() [2/2]

INvSIPLBuffer& nvsipl::INvSIPLClient::INvSIPLBuffer::operator= ( INvSIPLBuffer &  other) &
delete

◆ Release()

virtual SIPLStatus nvsipl::INvSIPLClient::INvSIPLBuffer::Release ( )
pure virtual

Release a reference.

Once the reference has been released as many times as the reference was added, it implies that the user has finished working with the buffer and the buffer is available for re-use by SIPL.

Precondition
None.

Release() originates the following SIPLStatus return values:

Return values
NVSIPL_STATUS_OKThe releasing operation succeeds.
NVSIPL_STATUS_BAD_ARGUMENTIf the buffer is already released.
SIPLStatusOther values of SIPLStatus are propagated.


Usage considerations

  • Allowed context for the API call
    • Interrupt handler: No
    • Signal handler: No
    • Thread-safe: Yes
    • Re-entrant: No
    • Async/Sync: Sync
  • Required privileges: Yes, with the following conditions:
    • Grants: nonroot, allow
    • Abilities: public_channel
    • Application needs to have access to the SGIDs that SIPL depends on as mentioned in the NVIDIA DRIVE OS Safety Developer Guide
  • API group
    • Init: No
    • Runtime: Yes
    • De-Init: No
The documentation for this class was generated from the following file: