Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlDevDisplay_LockForRead Function
Primary Display Capture

Locks the primary screen buffer disallowing any updates to the data it contains.

Syntax
PRL_RESULT PrlDevDisplay_LockForRead(
    PRL_HANDLE hObj
);
File

PrlApiVm.h

Parameters

hObj

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed. 

PRL_ERR_SUCCESS - function completed successfully. 

Remarks

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.

Links
© 2021 Parallels International GmbH. All rights reserved.