Retrieve the current value of the specified device property of type char.
#include <screen/screen.h>
int screen_get_device_property_cv(screen_device_t dev, int pname, int len, char *param)
The handle of the device whose property is being queried.
The name of the property whose value is being queried. The properties available for query are of type Screen property types.
The maximum number of bytes that can be written to param.
The buffer where the retrieved value(s) will be stored. This buffer must be an array of type char with a maximum length of len.
Function Type: Flushing Execution
This function stores the current value of a device property in a user-provided buffer. No more than len bytes of the specified type will be written.
0 if a query was successful and the value(s) of the property are stored in param, or -1 if an error occurred (errno is set; refer to /usr/include/errno.h for more details). Note that the error may also have been caused by any delayed execution function that's just been flushed.