| libmm-glib Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | ||||
struct MMModemSignal; const gchar * mm_modem_signal_get_path (MMModemSignal *self); gchar * mm_modem_signal_dup_path (MMModemSignal *self); guint mm_modem_signal_get_rate (MMModemSignal *self); MMSignal * mm_modem_signal_peek_cdma (MMModemSignal *self); MMSignal * mm_modem_signal_get_cdma (MMModemSignal *self); MMSignal * mm_modem_signal_peek_evdo (MMModemSignal *self); MMSignal * mm_modem_signal_get_evdo (MMModemSignal *self); MMSignal * mm_modem_signal_peek_gsm (MMModemSignal *self); MMSignal * mm_modem_signal_get_gsm (MMModemSignal *self); MMSignal * mm_modem_signal_peek_umts (MMModemSignal *self); MMSignal * mm_modem_signal_get_umts (MMModemSignal *self); MMSignal * mm_modem_signal_peek_lte (MMModemSignal *self); MMSignal * mm_modem_signal_get_lte (MMModemSignal *self); void mm_modem_signal_setup (MMModemSignal *self,guint rate,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean mm_modem_signal_setup_finish (MMModemSignal *self,GAsyncResult *res,GError **error); gboolean mm_modem_signal_setup_sync (MMModemSignal *self,guint rate,GCancellable *cancellable,GError **error);
MMModemSignal implements GDBusInterface, GInitable, GAsyncInitable and MmGdbusModemSignal.
The MMModemSignal is an object providing access to the methods, signals and properties of the Signal interface.
The Signal interface is exposed whenever a modem has extended signal retrieval capabilities.
struct MMModemSignal;
The MMModemSignal structure contains private data and should only be accessed using the provided API.
const gchar * mm_modem_signal_get_path (MMModemSignal *self);
Gets the DBus path of the MMObject which implements this interface.
|
A MMModemSignal. |
Returns : |
The DBus path of the MMObject object. [transfer none] |
gchar * mm_modem_signal_dup_path (MMModemSignal *self);
Gets a copy of the DBus path of the MMObject object which implements this interface.
|
A MMModemSignal. |
Returns : |
The DBus path of the MMObject. The returned value should be freed with g_free(). [transfer full]
|
guint mm_modem_signal_get_rate (MMModemSignal *self);
Gets the currently configured refresh rate.
|
A MMModemSignal. |
Returns : |
the refresh rate, in seconds. |
MMSignal * mm_modem_signal_peek_cdma (MMModemSignal *self);
Gets a MMSignal object specifying the CDMA signal information.
self was constructed. Use mm_modem_signal_get_cdma() if on another
thread.
MMSignal * mm_modem_signal_get_cdma (MMModemSignal *self);
Gets a MMSignal object specifying the CDMA signal information.
self are not updated when the values in the
interface change. Instead, the client is expected to call
mm_modem_signal_get_cdma() again to get a new MMSignal with the
new values.
|
A MMModem. |
Returns : |
A MMSignal that must be freed with g_object_unref() or NULL if unknown. [transfer full]
|
MMSignal * mm_modem_signal_peek_evdo (MMModemSignal *self);
Gets a MMSignal object specifying the EV-DO signal information.
self was constructed. Use mm_modem_signal_get_evdo() if on another
thread.
MMSignal * mm_modem_signal_get_evdo (MMModemSignal *self);
Gets a MMSignal object specifying the EV-DO signal information.
self are not updated when the values in the
interface change. Instead, the client is expected to call
mm_modem_signal_get_evdo() again to get a new MMSignal with the
new values.
|
A MMModem. |
Returns : |
A MMSignal that must be freed with g_object_unref() or NULL if unknown. [transfer full]
|
MMSignal * mm_modem_signal_peek_gsm (MMModemSignal *self);
Gets a MMSignal object specifying the GSM signal information.
self was constructed. Use mm_modem_signal_get_gsm() if on another
thread.
MMSignal * mm_modem_signal_get_gsm (MMModemSignal *self);
Gets a MMSignal object specifying the GSM signal information.
self are not updated when the values in the
interface change. Instead, the client is expected to call
mm_modem_signal_get_gsm() again to get a new MMSignal with the
new values.
|
A MMModem. |
Returns : |
A MMSignal that must be freed with g_object_unref() or NULL if unknown. [transfer full]
|
MMSignal * mm_modem_signal_peek_umts (MMModemSignal *self);
Gets a MMSignal object specifying the UMTS signal information.
self was constructed. Use mm_modem_signal_get_umts() if on another
thread.
MMSignal * mm_modem_signal_get_umts (MMModemSignal *self);
Gets a MMSignal object specifying the UMTS signal information.
self are not updated when the values in the
interface change. Instead, the client is expected to call
mm_modem_signal_get_umts() again to get a new MMSignal with the
new values.
|
A MMModem. |
Returns : |
A MMSignal that must be freed with g_object_unref() or NULL if unknown. [transfer full]
|
MMSignal * mm_modem_signal_peek_lte (MMModemSignal *self);
Gets a MMSignal object specifying the LTE signal information.
self was constructed. Use mm_modem_signal_get_lte() if on another
thread.
MMSignal * mm_modem_signal_get_lte (MMModemSignal *self);
Gets a MMSignal object specifying the LTE signal information.
self are not updated when the values in the
interface change. Instead, the client is expected to call
mm_modem_signal_get_lte() again to get a new MMSignal with the
new values.
|
A MMModem. |
Returns : |
A MMSignal that must be freed with g_object_unref() or NULL if unknown. [transfer full]
|
void mm_modem_signal_setup (MMModemSignal *self,guint rate,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously setups the extended signal quality retrieval.
When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from.
You can then call mm_modem_signal_setup_finish() to get the result of the operation.
See mm_modem_signal_setup_sync() for the synchronous, blocking version of this method.
|
A MMModemSignal. |
|
Rate to use when refreshing signal values. |
|
A GCancellable or NULL. [allow-none]
|
|
A GAsyncReadyCallback to call when the request is satisfied or NULL. |
|
User data to pass to callback. |
gboolean mm_modem_signal_setup_finish (MMModemSignal *self,GAsyncResult *res,GError **error);
Finishes an operation started with mm_modem_signal_setup().
|
A MMModemSignal. |
|
The GAsyncResult obtained from the GAsyncReadyCallback passed to mm_modem_signal_setup(). |
|
Return location for error or NULL. |
Returns : |
TRUE if the setup was successful, FALSE if error is set. |
gboolean mm_modem_signal_setup_sync (MMModemSignal *self,guint rate,GCancellable *cancellable,GError **error);
Synchronously setups the extended signal quality retrieval.
The calling thread is blocked until a reply is received. See mm_modem_signal_setup()
for the asynchronous version of this method.
|
A MMModemSignal. |
|
Rate to use when refreshing signal values. |
|
A GCancellable or NULL. [allow-none]
|
|
Return location for error or NULL. |
Returns : |
TRUE if the setup was successful, FALSE if error is set. |