GetBinaryData

Navigation:  NxLib API > C# Interface / CLI > NxLibItem >

GetBinaryData

Previous pageReturn to chapter overviewNext page

Retrieves data of a Binary item.

Signatures

Note: This function returns the binary item data in an array. The array object will automatically be resized to fit the data. If the binary data size is not divisible the the vector element size an error will be returned.

Variants throwing exceptions on API errors:

generic <typename T>
void GetBinaryData(Out array<T> destinationBuffer, Out int numBytesCopied, Out double timestamp)

void GetBinaryDataByte(Out array<Byte> destinationBuffer, Out int numBytesCopied, Out double timestamp)

void GetBinaryDataShort(Out array<Short> destinationBuffer, Out int numBytesCopied, Out double timestamp)

void GetBinaryDataFloat(Out array<Float> destinationBuffer, Out int numBytesCopied, Out double timestamp)

Variants returning API errors as int parameter:

generic <typename T>
void GetBinaryData(Out int returnCode, Out array<T> destinationBuffer, Out int numBytesCopied, Out double timestamp)

void GetBinaryDataByte(Out int returnCode, Out array<Byte> destinationBuffer, Out int numBytesCopied, Out double timestamp)

void GetBinaryDataShort(Out int returnCode, Out array<Short> destinationBuffer, Out int numBytesCopied, Out double timestamp)

void GetBinaryDataFloat(Out int returnCode, Out array<Float> destinationBuffer, Out int numBytesCopied, Out double timestamp)

Parameters

returnCode

The error code returned when accessing the item.

destinationBuffer

The array where the binary data will be copied to. The function will take care of allocating an array object of sufficient size.

numBytesCopied

Pointer to an integer, can be 0. If non-zero the value will be set to the number of bytes actually copied to the user's buffer.

timestamp

Timestamp when the binary blob was generated. This pointer can be set to zero when the time stamp should not be retrieved.

Return Value

none