zmap_tile_SetLock

Depending on the function arguments, this function:

• Locks a mosaic tile in memory so that it will not be de-cached until the lock is released, or;
• Releases the lock on a mosaic tile.

bool zmap_tile_SetLock(void* hTile, bool LockState);

False if an error occurred, and true otherwise.

Do not call zmap_tile_SetLock in a file format plugin when loading/saving a mosaic tile, as zmap_tile_SetLock may load/save the tile in question, which calls your function again, and we have a recursive infinite loop.

Tiles are not automatically unloaded when zmap_tile_SetLock is called with a LockState argument of false, as different threads/plugins may have locks on the same tile. Calling zmap_tile_SetLock with a LockState of false will not release these other locks.

Title says it all.