HDF5 objects include datasets, groups, and committed datatypes. Only
hid_t identifiers that represent these objects can be passed to this function.
Passing in a
hid_t identifier that represents any other HDF5 entity is considered an error.
It is an error to pass an HDF5 file identifier (obtained from H5F_OPEN or H5F_CREATE) to this function. Use H5F_DISABLE_MDC_FLUSHES instead.
Misuse of this function can cause the cache to exhaust available memory.
Objects can be returned to the default automatic flush behavior with H5O_ENABLE_MDC_FLUSHES.
Flush prevention only pertains to new or dirty metadata entries. Clean entries can be evicted from the cache.
Calling this function on an object that has already had flushes disabled will return an error.