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_id | IN: 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_SUPER | Super block data |
H5FD_MEM_BTREE | B-tree data |
H5FD_MEM_DRAW | Dataset raw data |
H5FD_MEM_GHEAP | Global heap data |
H5FD_MEM_LHEAP | Local Heap data |
H5FD_MEM_OHDR | Object 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:
History:
| Release | Change |
|---|
| 1.6.0 | C function introduced in this release. |
--- Last Modified: July 23, 2019 | 08:20 AM
