Motivation:H5P_SET_FILE_IMAGE_CALLBACKS and other elements of HDF5 are used to load an image of an HDF5 file into system memory and open that image as a regular HDF5 file. An application can then use the file without the overhead of disk I/O.
Recommended Reading: This function is part of the file image operations feature set. It is highly recommended to study the guide “HDF5 File Image Operations” before using this feature set. See the “See Also” section below for links to other elements of HDF5 file image operations.
IN/OUT: Pointer to the instance of the H5_file_image_callbacks_t struct in which the callback routines are to be returned
Struct fields must be initialized to NULL before the call is made.
Struct field contents upon return will match those passed in in the last H5P_SET_FILE_IMAGE_CALLBACKS call for the file access property list fapl_id.
H5P_SET_FILE_IMAGE_CALLBACKSretrieves the callback routines set for working with file images opened with the file access property list fapl_id.
The callbacks must have been previously set with H5P_SET_FILE_IMAGE_CALLBACKS in the file access property list.
Upon the successful return of H5P_SET_FILE_IMAGE_CALLBACKS, the fields in the instance of the H5_file_image_callbacks_t struct pointed to by callbacks_ptr will contain the same values as were passed in the most recent H5P_SET_FILE_IMAGE_CALLBACKS call for the file access property list fapl_id.
Returns a non-negative value if successful; otherwise returns a negative value.