Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5P_SET_FILTER_CALLBACK

Sets user-defined filter callback function

Procedure:

H5P_SET_FILTER_CALLBACK ( plist, func, op_data)

Signature:

herr_t H5Pset_filter_callback(hid_t plist,
                         H5Z_filter_func_t func,
                         void *op_data)
  

NONE

Parameters:
hid_t plistIN: Dataset transfer property list identifier
H5Z_filter_func_t func    IN: User-defined filter callback function
void *op_dataIN: User-defined input data for the callback function

Description:

H5P_SET_FILTER_CALLBACK sets the user-defined filter callback function func in the dataset transfer property list plist.

The parameter op_data is a pointer to user-defined input data for the callback function and will be passed through to the callback function.

The callback function func defines the actions an application is to take when a filter fails. The function prototype is as follows:

typedef H5Z_cb_return_t (H5Z_filter_func_t) (H5Z_filter_t filter_id, void *buf, size_t buf_size, void *op_data)

where filter_id indicates which filter has failed, buf and buf_size are used to pass in the failed data, and op_data is the required input data for this callback function.

Valid callback function return values are H5Z_CB_FAIL and H5Z_CB_CONT.

Returns:

Example:

Coming Soon!

History:
Release    C
1.6.0Function introduced in this release.

--- Last Modified: January 03, 2018 | 09:20 AM