PrlDevDisplay_GetDynResToolStatus Function

Determines whether Dynamic Resolution feature is available in the specified virtual machine.

Syntax

PRL_RESULT PrlDevDisplay_GetDynResToolStatus(
    PRL_HANDLE hVm, 
    PRL_BOOL_PTR status
);

File

PrlApi.h

Parameters

hVm

A handle of type PHT_VIRTUAL_MACHINE identifying the virtual machine.

status

[out] A pointer to a variable that receives the result. PRL_TRUE indicates that Dynamic Resolution is enabled. PRL_FALSE indicates otherwise.

Returns

PRL_RESULT . Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Remarks

Dynamic Resolution is a feature that comes with the Parallels Tools package. It provides facilities for adjusting the guest OS screen resolution on the fly. Use this function to determine whether the Dynamic Resolution feature is installed and running. If the feature is available, you can use the PrlDevDisplay_SendScreenSizeEvent function to programmatically adjust the guest OS screen resolution.

Links

PrlApi.h , Primary Display Capture