This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PdIsOffscreenLocked()

Determine whether or not an offscreen context is locked

Synopsis:

int PdIsOffscreenLocked(
       PdOffscreenContext_t *osc );

Arguments:

osc

A pointer to the offscreen context, as returned by PdCreateOffscreenContext(), that you want to check.

Library:

ph

Description:

This function tests to see if the given offscreen context is currently locked.

---

This is really only useful for debugging purposes, because the state of the lock could potentially change between the time that PdIsOffscreenLocked() queries the status and reports it back to the application.

---

Returns:

One of:

• Pg_OSC_LOCKED
• Pg_OSC_LOCK_INVALID
• Pg_OSC_NOT_LOCKED

Classification:

Photon

See also:

PdCreateOffscreenLock(), PdDestroyOffscreenLock(), PdGetOffscreenContextPtr(), PdLockOffscreen(), PdUnlockOffscreen()

"Offscreen locks" in the Raw Drawing and Animation chapter of the Photon Programmer's Guide