Iray SDK API nvidia_logo_transpbg.gif Up
mi::neuraylib::IHead_node_callback Class Referenceabstract

Abstract interface for signaling a change of the cluster application head node. More...

#include <inode_manager.h>

Inheritance diagram for mi::neuraylib::IHead_node_callback:

Public Member Functions

virtual void head_node_callback (IWorker_node_descriptor *worker_descriptor)=0
 This function is called when a cluster node becomes cluster head node. More...
 
- Public Member Functions inherited from mi::base::IInterface
virtual Uint32 retain () const =0
 Increments the reference count. More...
 
virtual Uint32 release () const =0
 Decrements the reference count. More...
 
virtual const IInterfaceget_interface (const Uuid &interface_id) const =0
 Acquires a const interface from another. More...
 
template<class T>
const T * get_interface () const
 Acquires a const interface from another. More...
 
virtual IInterfaceget_interface (const Uuid &interface_id)=0
 Acquires a mutable interface from another. More...
 
template<class T>
T * get_interface ()
 Acquires a mutable interface from another. More...
 
virtual Uuid get_iid () const =0
 Returns the interface ID of the most derived interface. More...
 

Additional Inherited Members

- Public Types inherited from mi::base::Interface_declare< 0xf07bba0e, ... >
typedef Interface_declare< id1, ... > Self
 Own type. More...
 
typedef Uuid_t< id1, ... > IID
 Declares the interface ID (IID) of this interface. More...
 
- Public Types inherited from mi::base::IInterface
typedef Uuid_t<0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0> IID
 Declares the interface ID (IID) of this interface. More...
 
- Static Public Member Functions inherited from mi::base::Interface_declare< 0xf07bba0e, ... >
static bool compare_iid (const Uuid &iid)
 Compares the interface ID iid against the interface ID of this interface and of its ancestors. More...
 
- Static Public Member Functions inherited from mi::base::IInterface
static bool compare_iid (const Uuid &iid)
 Compares the interface ID iid against the interface ID of this interface. More...
 

Detailed Description

Abstract interface for signaling a change of the cluster application head node.

Its aim is to be derived from by the application writer. The concrete implementation can then be registered with the Iray SDK API and will after that be used by the Iray library.

Note
Instances of this interface should not be created on the stack, since this might lead to premature destruction of such instances while still being in use by the Iray SDK.
See also
mi::neuraylib::INode_manager_cluster::get_head_node to retrieve the cluster head node.

Member Function Documentation

 head_node_callback()

virtual void mi::neuraylib::IHead_node_callback::head_node_callback ( IWorker_node_descriptor worker_descriptor)
pure virtual

This function is called when a cluster node becomes cluster head node.

This should not be confused with the head node in TCP networking as it is unrelated.

It should return as soon as possible because it may block further network operations.

Parameters
worker_descriptorThe descriptor of the cluster head node.