pcoip_sync_on_bitmap_ex

Example Teradici PCoIP Protocol

Computes the hash of a bitmap and waits a specified amount of time for the computed hash to match the hash passed on as parameter.

int pcoip_sync_on_bitmap_ex( long x, long y, long width, long height, char *hash, long timeout);

x The horizontal distance, in pixels, of the bitmap's top left edge from the left border of the client window.
y The vertical distance, in pixels, of the bitmap's top left edge from the upper border of the client window
width The width, in pixels, of the bitmap.
height The height, in pixels, of the bitmap.
hash An encoded string representing the bitmap.
timeout The amount of time, in seconds, to wait until the expected hash matches the actual obtained hash.

General

pcoip_sync_on_bitmap_ex is a synchronization function that waits a specified amount of time for a specified bitmap to appear before continuing.

This function is available only where snapshots were taken. For more information, see Teradici PCoIP (PC over IP) Protocol in the LoadRunner Help Center.

Return Values

E_OK  
E_ALREADY_CONNECTED Do not call this function after the connection is established.
E_NOT_CONNECTED Action cannot be performed. There is no connection to the remote server.
E_OUT_OF_TIME Function timed out.
E_ILLEGAL_PARAMETER Illegal parameter found.
E_INTERNAL Internal error found.

Parameterization

Standard parameterization is not available for this function.

Example

pcoip_sync_on_bitmap_ex is similar to the pcoip_sync_on_bitmap, only it contains its own timeout, instead of waiting for the global timeout.

pcoip_sync_on_bitmap_ex(137, 211, 51, 17,
	"18d962dcbf373e948e83489a19419512", 30);