Locks the primary screen buffer disallowing any updates to the data it contains.
PRL_RESULT PrlDevDisplay_LockForRead( PRL_HANDLE hObj );
PrlApiVm.h
PRL_RESULT. Possible values:
PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.
PRL_ERR_SUCCESS - function completed successfully.
When you obtain a screen capture, you should call this function first to prevent all further updates to the screen buffer. This is done in order to minimize the local machine resource usage, to speed up the screen buffer read operations, and to prevent possible data loss. To obtain the data from the buffer, use the PrlDevDisplay_GetScreenBuffer function. When you are done reading the data, call the PrlDevDisplay_Unlock to remove the lock.
