Name: H5Pset_driver
Signature:
herr_t H5Pset_driver( hid_t plist_id, hid_t new_driver_id, const void *new_driver_info )

Purpose:
Sets a file driver.

Description:
H5Pset_driver sets the file driver, new_driver_id, for a file access or data transfer property list, plist_id, and supplies an optional struct containing the driver-specific properties, new_driver_info.

The driver properties will be copied into the property list and the reference count on the driver will be incremented, allowing the caller to close the driver identifier but still use the property list.

Note:
H5Pset_driver and H5Pget_driver_info 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.
hid_t new_driver_id
IN: Driver identifier.
const void * new_driver_info
IN: Optional struct containing driver properties.

Returns:
Returns a non-negative value if successful. Otherwise returns a negative value.

Fortran90 Interface:
None.

History: