OutOfBand Struct Reference

A container for Out-of-Band data. More...

#include <das2/oob.h>

Inheritance diagram for OutOfBand:

Public Member Functions
DAS_API DasErrCode	OutOfBand_decode (DasBuf *pBuf, OutOfBand **ppObjs, int *which)
	Factory function to produce out of band objects from general data. More...

Detailed Description

A container for Out-of-Band data.

Member Function Documentation

OutOfBand_decode()

DAS_API DasErrCode OutOfBand_decode	(	DasBuf *	pBuf,
		OutOfBand **	ppObjs,
		int *	which
	)

Factory function to produce out of band objects from general data.

Unlike Header packets which are read in-frequently, out of band objects may occur frequently in the input stream. To avoid alot of memory allocations This factory function takes an array of pointers to out of band objects.

If one of the given OOB's in the input array corresponds to the parsed object then it is initialize with the values in the buffer. If the out of band object is a proper XML item but is not understood by this function it is just ignored and which will be set to -1

Parameters

[in]	pBuf	a readable buffer containing up to one out of band object
[in]	ppObjs	a NULL terminated array of out of band objects to possibly populate with data
[out]	which	A pointer to an integer. The integer will be set to -1 if the object was not parseable or if no structure was provided in ppObjs to hold the parsed item.

Returns

0 on success or a positive error code if there is a problem.

---

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

• das2/oob.h