tibrvMsgData_Malloc()

Function

Declaration

void* tibrvMsgData_Malloc(
    tibrv_u32    size);

Purpose

Allocate process storage for decoders and converters.

Remarks

Decoders and converters must use this layer 1 function to allocate storage for extracted data. Do not use ordinary malloc.

The function returns a pointer to the storage. The storage remains associated with the message, and persists until the message is destroyed. Programmers need not free this storage; instead, the message automatically frees the storage at the appropriate time.

Decoders and converters that allocate storage using this function must pass back the type tibrvMsgData_MallocBlock.

Parameter

Description

size

Allocate a storage block of this size (in bytes).

See Also

tibrvMsgDataType

tibrvMsgData_Converter

tibrvMsgData_Decoder

tibrvMsgData_Encoder