SEDRIS Reference Manual
APPENDIX B - Transmittal Access Level 1 API
Functions
SE GetDataTableSubExtent
extern SE_Status_Code
SE_GetDataTableSubExtent
(
SE_Object  data_table,1
SE_Data_Table_Sub_Extent  *extents_ptr,2
SE_Integer_Unsigned  *cell_count_ptr3
);

Definition

Allocates and initializes the axes_bounds array for extents, and computes the number of cells in the table. Memory allocated by this function should be freed via SE_FreeDataTableSubExtent().


Returns

SE_STATCODE_SUCCESS and *extents_ptr is allocated and the output parameters are initialized to the appropriate values, if valid parameters were passed in and all operations succeeded.
SE_STATCODE_UNRESOLVED_INPUT_OBJECT and no changes are made, if data_table is an unresolved DRM object.
SE_STATCODE_UNRESOLVED_OUTPUT_OBJECT and no changes are made, if an unresolved object was encountered and could not be resolved.
SE_STATCODE_INACTIONABLE_FAILURE and no changes are made, if
  1. an <Axis> or its fields could not be retrieved,
  2. an invalid <Axis> was encountered,
  3. the call fails for any other reason.

Parameters Notes

1 <Data Table> whose extents are being found

2 pointer to extents whose axes_bounds array is allocated and initialized here

3 pointer to a variable in the user's memory space, which is set to the number of cells in the <Data Table>


Prev: SE_GetDataTableSignature. Next: SE_GetRearrangedImageData. Up:Index.