IDS peak genericC++ v1.17.0
Loading...
Searching...
No Matches
peak::core::DataStreamDescriptor Class Reference

Encapsulates the GenTL functions associated with a GenTL DataStream module's ID. More...

#include <peak/data_stream/peak_data_stream_descriptor.hpp>

Inheritance diagram for peak::core::DataStreamDescriptor:
peak::core::ModuleDescriptor

Public Member Functions

 DataStreamDescriptor ()=delete
 ~DataStreamDescriptor () override=default
 DataStreamDescriptor (const DataStreamDescriptor &other)=delete
DataStreamDescriptor & operator= (const DataStreamDescriptor &other)=delete
 DataStreamDescriptor (DataStreamDescriptor &&other)=delete
DataStreamDescriptor & operator= (DataStreamDescriptor &&other)=delete
PEAK_COMMON_NO_DISCARD std::string Key () const
 Returns the unique key.
PEAK_COMMON_NO_DISCARD std::shared_ptr< Device > ParentDevice () const
 Returns the parent device.
PEAK_COMMON_NO_DISCARD std::shared_ptr< DataStream > OpenDataStream ()
 Opens the data stream.
PEAK_COMMON_NO_DISCARD std::shared_ptr< DataStream > OpenedDataStream () const
 Returns the DataStream that was opened with this DataStreamDescriptor.
PEAK_COMMON_NO_DISCARD std::shared_ptr< DataStream > EnsureOpenedDataStream ()
 Returns the opened data stream or opens it if it is not already open.
PEAK_COMMON_NO_DISCARD bool IsOpened () const
 Returns whether the data stream is open.
Public Member Functions inherited from peak::core::ModuleDescriptor
 ModuleDescriptor ()=default
virtual ~ModuleDescriptor ()=default
 ModuleDescriptor (const ModuleDescriptor &other)=delete
ModuleDescriptor & operator= (const ModuleDescriptor &other)=delete
 ModuleDescriptor (ModuleDescriptor &&other)=delete
ModuleDescriptor & operator= (ModuleDescriptor &&other)=delete
PEAK_COMMON_NO_DISCARD std::string ID () const
 Returns the ID of the described module.

Detailed Description

Encapsulates the GenTL functions associated with a GenTL DataStream module's ID.

This class allows to query information about a GenTL DataStream module without opening it. Furthermore, it allows to open this GenTL DataStream module.

Constructor & Destructor Documentation

◆ DataStreamDescriptor() [1/3]

peak::core::DataStreamDescriptor::DataStreamDescriptor ( )
delete

◆ ~DataStreamDescriptor()

peak::core::DataStreamDescriptor::~DataStreamDescriptor ( )
overridedefault

◆ DataStreamDescriptor() [2/3]

peak::core::DataStreamDescriptor::DataStreamDescriptor ( const DataStreamDescriptor & other)
delete

◆ DataStreamDescriptor() [3/3]

peak::core::DataStreamDescriptor::DataStreamDescriptor ( DataStreamDescriptor && other)
delete

Member Function Documentation

◆ EnsureOpenedDataStream()

std::shared_ptr< DataStream > peak::core::DataStreamDescriptor::EnsureOpenedDataStream ( )
inline

Returns the opened data stream or opens it if it is not already open.

Returns
Opened data stream
Since
1.17
Exceptions
BadAccessExceptionAccess denied
InternalErrorExceptionAn internal error has occurred.

◆ IsOpened()

bool peak::core::DataStreamDescriptor::IsOpened ( ) const
inline

Returns whether the data stream is open.

Returns
true if the data stream is open, otherwise false
Since
1.17

◆ Key()

std::string peak::core::DataStreamDescriptor::Key ( ) const
inline

Returns the unique key.

The returned key is unique even across different producer libraries.

Returns
Unique key
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

◆ OpenDataStream()

std::shared_ptr< DataStream > peak::core::DataStreamDescriptor::OpenDataStream ( )
inline

Opens the data stream.

Returns
Opened data stream
Since
1.0
Exceptions
BadAccessExceptionAccess denied
InternalErrorExceptionAn internal error has occurred.

◆ OpenedDataStream()

std::shared_ptr< DataStream > peak::core::DataStreamDescriptor::OpenedDataStream ( ) const
inline

Returns the DataStream that was opened with this DataStreamDescriptor.

Returns
Opened DataStream
Since
1.0
Exceptions
BadAccessExceptionDataStream is not open

◆ operator=() [1/2]

DataStreamDescriptor & peak::core::DataStreamDescriptor::operator= ( const DataStreamDescriptor & other)
delete

◆ operator=() [2/2]

DataStreamDescriptor & peak::core::DataStreamDescriptor::operator= ( DataStreamDescriptor && other)
delete

◆ ParentDevice()

std::shared_ptr< Device > peak::core::DataStreamDescriptor::ParentDevice ( ) const
inline

Returns the parent device.

Returns
Parent device
Since
1.0
Exceptions
InternalErrorExceptionAn internal error has occurred.

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