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:

Release | C
1.8.2 | Function publicized in this release; previous releases described this function only in the virtual file driver documentation.