H5F_GET_MDC_IMAGE_INFO returns information about a cache image if it exists. When an HDF5 file is opened in Read/Write mode, any metadata cache image will be read and deleted from the file on the first metadata cache access (or, if persistent free space managers are enabled, on the first file space allocation / deallocation, or read of free space manager status, whichever comes first). Thus, if the file is opened Read/Write, H5F_GET_MDC_IMAGE_INFO should be called immediately after file open and before any other operation. If H5F_GET_MDC_IMAGE_INFO is called after the cache image is loaded, it will correctly report that no cache image exists, as the image will have already been read and deleted from the file. In the Read Only case, the function may be called at any time, as any cache image will not be deleted from the file. |