Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5P_SET_MULTI_TYPE

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

Procedure:

H5P_SET_MULTI_TYPE ( fapl_id, type )

Signature:

herr_t H5Pset_multi_type (
                        hid_t fapl_id,
                        H5FD_mem_t type
    )
  

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

Description:

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:

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

Example:

Coming Soon!

History:
Release    Change
1.6.0C function introduced in this release.

--- Last Modified: December 04, 2017 | 08:52 AM