Top | ![]() |
![]() |
![]() |
![]() |
The property probe is a way to autodetect allowed values for a GObject property. It's primary use is to autodetect device-names in several elements.
The interface is implemented by many hardware sources and sinks.
const GList *
gst_property_probe_get_properties (GstPropertyProbe *probe
);
Get a list of properties for which probing is supported.
the list of GParamSpec * pointers representing properties for which probing is supported by this element.
const GParamSpec * gst_property_probe_get_property (GstPropertyProbe *probe
,const gchar *name
);
Get GParamSpec for a property for which probing is supported.
GValueArray * gst_property_probe_get_values (GstPropertyProbe *probe
,const GParamSpec *pspec
);
Gets the possible (probed) values for the given property, requires the property to have been probed before.
GValueArray * gst_property_probe_get_values_name (GstPropertyProbe *probe
,const gchar *name
);
Same as gst_property_probe_get_values()
.
gboolean gst_property_probe_needs_probe (GstPropertyProbe *probe
,const GParamSpec *pspec
);
Checks whether a property needs a probe. This might be because the property wasn't initialized before, or because host setup changed. This might be, for example, because a new device was added, and thus device probing needs to be refreshed to display the new device.
probe |
the GstPropertyProbe object to which the given property belongs. |
|
pspec |
a GParamSpec that identifies the property to check. |
gboolean gst_property_probe_needs_probe_name (GstPropertyProbe *probe
,const gchar *name
);
Same as gst_property_probe_needs_probe()
.
probe |
the GstPropertyProbe object to which the given property belongs. |
|
name |
the name of the property to check. |
GValueArray * gst_property_probe_probe_and_get_values (GstPropertyProbe *probe
,const GParamSpec *pspec
);
Check whether the given property requires a new probe. If so, fo the probe. After that, retrieve a value list. Meant as a utility function that wraps the above functions.
GValueArray * gst_property_probe_probe_and_get_values_name (GstPropertyProbe *probe
,const gchar *name
);
void gst_property_probe_probe_property (GstPropertyProbe *probe
,const GParamSpec *pspec
);
Runs a probe on the property specified by pspec
void gst_property_probe_probe_property_name (GstPropertyProbe *probe
,const gchar *name
);
Runs a probe on the property specified by name
.
typedef struct _GstPropertyProbe GstPropertyProbe;
Opaque GstPropertyProbe data structure.
struct GstPropertyProbeInterface { GTypeInterface klass; /* signals */ void (*probe_needed) (GstPropertyProbe *probe, const GParamSpec *pspec); /* virtual functions */ const GList * (*get_properties) (GstPropertyProbe *probe); gboolean (*needs_probe) (GstPropertyProbe *probe, guint prop_id, const GParamSpec *pspec); void (*probe_property) (GstPropertyProbe *probe, guint prop_id, const GParamSpec *pspec); GValueArray * (*get_values) (GstPropertyProbe *probe, guint prop_id, const GParamSpec *pspec); };
GstPropertyProbe interface.
GTypeInterface |
parent interface type. |
|
default signal handler |
||
virtual method to get list of probable properties |
||
virtual method to tell if probe need update |
||
virtual method to probe a property |
||
virtual method to get probe results for a property |
“probe-needed”
signalvoid user_function (GstPropertyProbe *pspec, gpointer arg1, gpointer user_data)
pspec |
GParamSpec that needs a probe |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last