The transport's Connection interface structure, representing a transport-level connection. More...
Data Structures | |
| struct | DTLConnectionFns_t |
| The DTLConnection interface function structure, containing a list of function pointers that implement the interface. More... | |
The transport's Connection interface structure, representing a transport-level connection.
The Transport-specific Connection interface.
This interface encapsulates the transport-level implementation of a connection, and is implemented by a transport that is intended to work with the C OAL. These connections can be inbound or outbound, streaming (e.g., TCP) or datagram (e.g., UDP), and point-to-point or point-to-multipoint (e.g., a datagram socket capable of sending multicast or broadcast).
Connections are expected to be mostly immutable. Their properties are not expected to change, with the exception of the context (it may be both set and retrieved). The context is opaque to the connection.
This interface is called by a Transport Handler in the OAL.
This structure should be placed as the first element in a larger structure representing any necessary state of the Connection. All of the functions take as their first argument a pointer to this structure (a DTLConnection). Inside each function, it can thus be type-cast as a pointer to the larger structure to access the connection's state. If no additional state is required, this structure may be used directly.
Defined as a pointer to the DTLConnection_t structure. Refer to the structure for more information.