Specifies type of data to be accessed via the MULTI driver, enabling more direct access


H5P_SET_MULTI_TYPE ( fapl_id, type )


<pre><code class="language-c">herr_t H5Pset_multi_type (
                        hid_t fapl_id,
                        H5FD_mem_t type

hid_t fapl_idIN: File access property list identifier
H5FD_mem_t type    IN: Type of data to be accessed


H5P_SET_MULTI_TYPE sets the type of data property in the file access property list fapl_id.

This setting enables a user application to specify the type of data the application wishes to access so that the application can retrieve a file handle for low-level access to the particular member of a set of MULTI files in which that type of data is stored. The file handle is retrieved with a separate call to H5F_GET_VFD_HANDLE (or, in special circumstances, to  H5FD_GET_VFD_HANDLE; see Virtual File Layer and List of VFL Functions in HDF5 Technical Notes).

The type of data specified in type may be one of the following:

H5FD_MEM_SUPERSuper block data
H5FD_MEM_BTREE    B-tree data
H5FD_MEM_DRAWDataset raw data
H5FD_MEM_GHEAPGlobal heap data
H5FD_MEM_LHEAPLocal Heap data
H5FD_MEM_OHDRObject header data

This function is for use only when accessing an HDF5 file written as a set of files with the MULTI file driver.


Returns a non-negative value if successful; otherwise returns a negative value.


Coming Soon!

Release    Change
1.6.0C function introduced in this release.