Example 3: <Data Table> Extraction Functions [3 of 4]

SE_Status_Code SE_GetPackedDataTable

(

SE_Object data_table,

const SE_Data_Table_Sub_Extent *extents_ptr,

SE_Integer_Positive element_count,

const SE_Integer_Positive tbl_prop_descr_num[],

SE_Store store_in,

unsigned char **data_out_ptr

);

Data is organized as a stream of elemental types (SE_Byte, SE_Short_Integer_Unsigned, etc.) that are sequenced as specified by the tbl_prop_descr_num array.

element_count and tbl_prop_descr_num can be from SE_GetDataTableSignature() or a subset of elements from the list of elements.

extents_ptr can be set from SE_GetDataTableSubExtent() or can be a user defined sub-extents.

Returned data is placed in the memory area passed as data_out_ptr and managed by store_in.

Data is organized as a stream of elemental types (SE_Byte, SE_Short_Integer_Unsigned, etc.) that are sequenced as specified by the tbl_prop_descr_num array.