H5Pset_filter_callback
(hid_t plist
,
H5Z_filter_func_t func
,
void *op_data
)
H5Pset_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
.
hid_t plist |
IN: Dataset transfer property list identifier. |
H5Z_filter_func_t func |
IN: User-defined filter callback function. |
void *op_data |
IN: User-defined input data for the callback function. |
Release | C |
1.6.0 | Function introduced in this release. |