nvsipl::INvSIPLNotificationQueue Class Reference

Detailed Description

The interface to the notification queue.

Definition at line 420 of file NvSIPLPipelineMgr.hpp.

Public Member Functions
virtual SIPLStatus	Get (NvSIPLPipelineNotifier::NotificationData &item, size_t const timeoutUsec)=0
	Retrieve the next item from the queue. More...
virtual size_t	GetCount () const =0
	Return the current queue length. More...

Protected Member Functions
	INvSIPLNotificationQueue ()=default
virtual	~INvSIPLNotificationQueue ()=default

Constructor & Destructor Documentation

INvSIPLNotificationQueue()

nvsipl::INvSIPLNotificationQueue::INvSIPLNotificationQueue ( )

protecteddefault

~INvSIPLNotificationQueue()

virtual nvsipl::INvSIPLNotificationQueue::~INvSIPLNotificationQueue ( )

protectedvirtualdefault

Member Function Documentation

Get()

virtual SIPLStatus nvsipl::INvSIPLNotificationQueue::Get ( NvSIPLPipelineNotifier::NotificationData &  item, size_t const  timeoutUsec  )

pure virtual

Retrieve the next item from the queue.

Precondition

This function must be called after INvSIPLCamera::Init() and before INvSIPLCamera::Deinit().

Parameters

[out]	item	The item retrieved from the queue.
[in]	timeoutUsec	The timeout of the request, in microseconds. If the queue is empty at the time of the call, this method will wait up to timeoutUsec microseconds for a new item to arrive in the queue and be returned.

Return values

NVSIPL_STATUS_OK	if item has been successfully retrieved from the queue.
NVSIPL_STATUS_TIMED_OUT	if an item was not available within the timeout interval.
NVSIPL_STATUS_EOF	if the queue has been shut down. In this case, no further calls can be made on the queue object.
NVSIPL_STATUS_ERROR	if a system error occurred.

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

GetCount()

virtual size_t nvsipl::INvSIPLNotificationQueue::GetCount ( ) const

pure virtual

Return the current queue length.

Precondition

This function must be called after INvSIPLCamera::Init() and before INvSIPLCamera::Deinit().

Returns

the number of elements currently in the queue.

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

---

The documentation for this class was generated from the following file:

• NvSIPLPipelineMgr.hpp