Name: H5Pget_driver_info
Signature:
void *H5Pget_driver_info( hid_t plist_id )

Purpose:
Returns a pointer to file driver information.

Description:
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.

Note:
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.

Parameters:
hid_t plist_id
IN: File access or data transfer property list identifier.

Returns:
Returns a pointer to a struct containing low-level driver information. Otherwise returns NULL.

NULL is also returned if no driver-specific properties have been registered. No error is pushed on the stack in this case.

Non-C API(s):
None.

History: