CVB++ 14.0
PortNode Class Reference

Port nodes are the connection to the remote device. More...

#include <cvb/genapi/port_node.hpp>

Inherits Node.

Public Member Functions

void Read (std::int64_t address, void *buffer, size_t bufferLenght) const
 Reads memory from the remote device into the given buffer. More...
 
void Write (std::int64_t address, const void *buffer, size_t bufferLenght)
 Writes memory from the given buffer to the remote device. More...
 
- Public Member Functions inherited from Node
void * Handle () const noexcept
 Classic API node handle. More...
 
String Name () const
 Gets the full name of this node. More...
 
String DisplayName () const
 Gets the display name of this node. More...
 
String ToolTip () const
 Gets the short descriptive text of this node. More...
 
String Description () const
 Gets the long descriptive text of this node. More...
 
Cvb::GenApi::AccessMode AccessMode () const
 Gets the access mode of this node. More...
 
bool IsImplemented () const
 Helper to check whether this node is implemented. More...
 
bool IsAvailable () const
 Helper to check whether this node is available. More...
 
bool IsReadable () const
 Helper to check whether this node is readable. More...
 
bool IsWriteable () const
 Helper to check whether this node is writable. More...
 
Cvb::GenApi::CacheMode CacheMode () const
 Gets the cache mode of this node. More...
 
String EventID () const
 Nodes with an event identifier may become invalidated, if an event / message is delivered from the device. More...
 
bool IsFeature () const
 Returns whether this node is considered a feature node. More...
 
bool IsDeprecated () const
 Gets whether this node is considered deprecated. More...
 
Cvb::GenApi::Visibility Visibility () const
 Gets the complexity level of this node. More...
 
NodePtr AliasNode () const
 Gets the node, that is an alias value for this node. More...
 
EventCookie RegisterEventUpdated (std::function< void(Node &)> handler)
 Register a listener to node updated event. More...
 
void UnregisterEventUpdated (EventCookie eventCookie) noexcept
 Manually unregister a listener to the node updated event. More...
 
NodeMapPtr NodeMap () const noexcept
 Gets the node map this node resides in. More...
 

Detailed Description

Port nodes are the connection to the remote device.

Port nodes enable direct memory access on the remote device.

Member Function Documentation

◆ Read()

void Read ( std::int64_t  address,
void *  buffer,
size_t  bufferLenght 
) const
inline

Reads memory from the remote device into the given buffer.

Parameters
[in]addressAddress to read from.
[in]bufferBuffer to store data into.
[in]bufferLenghtNumber of bytes to read; buffer must have at least that many bytes of allocated memory.
Exceptions
Anyexception derived from std::exception including CvbException.

Use of this method is unsafe; prefer using the typed nodes instead.

◆ Write()

void Write ( std::int64_t  address,
const void *  buffer,
size_t  bufferLenght 
)
inline

Writes memory from the given buffer to the remote device.

Parameters
[in]addressAddress to write to.
[in]bufferBuffer to write to device.
[in]bufferLenghtNumber of bytes in the buffer.
Exceptions
Anyexception derived from std::exception including CvbException.

Use of this method is unsafe; prefer using the typed nodes instead.