H5Pget_driver_info
(
hid_t plist_id
)
H5Pget_driver_info
returns a pointer to
file driver-specific information for the low-level driver
associated with the file access or data transfer property list
plist_id
.
The pointer returned by this function points to an
“uncopied” struct.
Driver-specific versions of that struct are defined for each
low-level driver in the relevant source code file
H5FD*.c
.
For example, the struct used for the MULTI
driver
is H5FD_multi_fapl_t
defined in H5FDmulti.c
.
If no driver-specific properties have been registered,
H5Pget_driver_info
returns NULL
.
H5Pget_driver_info
and H5Pset_driver
are used only when creating a virtual file driver (VFD)
in the virtual file layer (VFL). For further information, see
“Virtual File Layer”
and “List of VFL
Functions” in the
HDF5 Technical Notes.
plist_id
NULL
.
NULL
is also returned if no driver-specific properties
have been registered.
No error is pushed on the stack in this case.
Release | C |
1.8.2 | Function publicized in this release; previous releases described this function only in the virtual file driver documentation. |