screen_get_event_property_pv()

Retrieve the current value of the specified event property of type void*

Synopsis:

#include <screen/screen.h>
int screen_get_event_property_pv(screen_event_t ev,
                                 int pname,
                                 void **param)

Arguments:

ev
The handle of the event whose property is being queried. The event must have an event type of Screen event types.
pname
The name of the property whose value is being queried. The properties available for query are of type Screen property types.
param
The buffer where the retrieved value(s) is stored. This buffer must be of type void*.

Library:

libscreen

Description:

Function Type: Immediate Execution

This function stores the current value of an event property in a user-provided buffer. The list of properties that can be queried per event type are listed as follows:

Event Type: Any
Note that when you're retrieving the following properties, Screen locally allocates resources to track the object that you retrieve:

Therefore, you must call the appropriate screen_destroy_*() function to free those resources when you no longer need to use the object in your local context.

Returns:

0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).