[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    NAME
	LockLayer -- Lock layer to make changes to ClipRects.

    SYNOPSIS
	LockLayer( dummy, l )
	           a0     a1

	void LockLayer( LONG, struct Layer *);

    FUNCTION
	Make this layer unavailable for other tasks to use.
	If another task is already using this layer then wait for
	it to complete and then reserve the layer for your own use.
	(this function does the same thing as graphics.library/LockLayerRom)

	Note: if you wish to lock MORE THAN ONE layer at a time, you
	    must call LockLayerInfo() before locking those layers and
	    then call UnlockLayerInfo() when you have finished. This
	    is to prevent system "deadlocks".

	Further Note: while you hold the lock on a layer, Intuition will block
	    on operations such as windowsizing, dragging, menus, and depth
	    arranging windows in this layer's screen.  It is recommended that
	    YOU do not make Intuition function calls while the layer is locked.

    INPUTS
	dummy - unused
	l - pointer to a layer

    BUGS

    SEE ALSO
	UnlockLayer(), LockLayerInfo(), UnlockLayerInfo(),
	graphics.library/LockLayerRom(), graphics/layers.h, graphics/clip.h