H5Pget_filter returns information about a
filter, specified by its filter number, in a filter pipeline,
specified by the property list with which it is associated.
If plist is a dataset creation property list,
the pipeline is a permanent filter pipeline;
if plist is a dataset transfer property list,
the pipeline is a transient filter pipeline.
On input, cd_nelmts indicates the number of entries
in the cd_values array, as allocated by the caller;
on return,cd_nelmts contains the number of values
defined by the filter.
filter_number is a value between zero and
N-1, as described in
H5Pget_nfilters().
The function will return a negative value if the filter number
is out of range.
If name is a pointer to an array of at least
namelen bytes, the filter name will be copied
into that array. The name will be null terminated if
namelen is large enough. The filter name returned
will be the name appearing in the file, the name registered
for the filter, or an empty string.
The structure of the flags argument is discussed
in H5Pset_filter().
