Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pg/pglocklayer.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pg/pglocklayer.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pg/pglocklayer.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pg/pglocklayer.html on line 8

PgLockLayer()

Lock a layer for exclusive use by an application

Synopsis:

int PgLockLayer( int layer );

Arguments:

layer
The layer index, which must be 0 or greater.

Library:

ph

Description:

PgLockLayer() acquires exclusive use of a layer by an application. To unlock a layer, call PgUnlockLayer().

Other applications may not use PgSetLayerSurface() or PgSetLayerArg() on a locked surface.


Note: You must target this function at a device by calling PdSetTargetDevice().

Your application should unlock its layers before it exits. You can lock a layer multiple times, but need to unlock it only once.

Returns:

0
Success.
-1
An error occurred (errno is set).

Errors:

EBUSY
The specified layer is locked by another application.
EINVAL
Any other error.
ENXIO
The layer doesn't exist.
EOPNOTSUPP
The operation isn't supported.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PdSetTargetDevice(), PgSetLayerArg(), PgSetLayerSurface(), PgUnlockLayer()

Layers in the Raw Drawing and Animation chapter of the Photon Programmer's Guide


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pg/pglocklayer.html on line 163

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pg/pglocklayer.html on line 163