Collapse All
Parallels Virtualization SDK
ContentsIndex
PreviousUpNext
PrlDevSecondaryDisplay_SendCaptureScreenRequest Function
Secondary Display Capture

Sends a request to capture the specified screen region of the secondary display of the specified virtual machine on a periodic basis.

Syntax
PRL_RESULT PrlDevSecondaryDisplay_SendCaptureScreenRequest(
    PRL_HANDLE hObj, 
    const PRL_IO_DISPLAY_SCREEN_REGION_PTR pRect
);
File

PrlApiVm.h

Parameters

hObj
pRect
Parameters of the screen region to capture. If negative rectangle is passed, cancellation request will be send.

Returns

PRL_RESULT. Possible values: 

PRL_ERR_INVALID_ARG - invalid handle or null pointer. 

PRL_ERR_SUCCESS - function completed successfully. 

Remarks

The screen data is received as an event via callback every time the specified screen region data is modified. This function is used when an efficient optimization of the screen update on the client side is needed.

Links
© 2021 Parallels International GmbH. All rights reserved.