Ms Basic Connect Extensions V3 service: libmbim-glib Reference Manual

Ms Basic Connect Extensions V3 service

Ms Basic Connect Extensions V3 service — Support for the Ms Basic Connect Extensions V3 service.

Functions

void	mbim_cell_info_serving_nr_array_free ()
void	mbim_cell_info_neighboring_nr_array_free ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_device_caps_response_parse ()
MbimMessage *	mbim_message_ms_basic_connect_extensions_v3_modem_configuration_query_new ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_modem_configuration_response_parse ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_modem_configuration_notification_parse ()
MbimMessage *	mbim_message_ms_basic_connect_extensions_v3_registration_parameters_query_new ()
MbimMessage *	mbim_message_ms_basic_connect_extensions_v3_registration_parameters_set_new ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_registration_parameters_response_parse ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_lte_attach_info_response_parse ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_lte_attach_info_notification_parse ()
MbimMessage *	mbim_message_ms_basic_connect_extensions_v3_base_stations_info_query_new ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_base_stations_info_response_parse ()
MbimMessage *	mbim_message_ms_basic_connect_extensions_v3_wake_reason_query_new ()
gboolean	mbim_message_ms_basic_connect_extensions_v3_wake_reason_response_parse ()

Types and Values

	MbimCellInfoServingNr
typedef	MbimCellInfoServingNrArray
	MbimCellInfoNeighboringNr
typedef	MbimCellInfoNeighboringNrArray

Description

This section implements support for requests, responses and notifications in the Ms Basic Connect Extensions V3 service.

Functions

mbim_cell_info_serving_nr_array_free ()

void
mbim_cell_info_serving_nr_array_free (MbimCellInfoServingNrArray *array);

Frees the memory allocated for the array of MbimCellInfoServingNr structs.

Parameters

array

a NULL terminated array of MbimCellInfoServingNr structs.

Since: 1.28

mbim_cell_info_neighboring_nr_array_free ()

void
mbim_cell_info_neighboring_nr_array_free
                               (MbimCellInfoNeighboringNrArray *array);

Frees the memory allocated for the array of MbimCellInfoNeighboringNr structs.

Parameters

array

a NULL terminated array of MbimCellInfoNeighboringNr structs.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_device_caps_response_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_device_caps_response_parse
                               (const MbimMessage *message,
                                MbimDeviceType *out_device_type,
                                MbimCellularClass *out_cellular_class,
                                MbimVoiceClass *out_voice_class,
                                MbimSimClass *out_sim_class,
                                MbimDataClassV3 *out_data_class,
                                MbimSmsCaps *out_sms_caps,
                                MbimCtrlCaps *out_control_caps,
                                MbimDataSubclass *out_data_subclass,
                                guint32 *out_max_sessions,
                                guint32 *out_executor_index,
                                guint32 *out_wcdma_band_class,
                                guint32 *out_lte_band_class_count,
                                guint16 **out_lte_band_class,
                                guint32 *out_nr_band_class_count,
                                guint16 **out_nr_band_class,
                                gchar **out_custom_data_class,
                                gchar **out_device_id,
                                gchar **out_firmware_info,
                                gchar **out_hardware_info,
                                GError **error);

Parses and returns parameters of the 'Device Caps' response command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_device_type	return location for a MbimDeviceType, or `NULL` if the 'DeviceType' field is not needed.	[out][optional][transfer none]
out_cellular_class	return location for a MbimCellularClass, or `NULL` if the 'CellularClass' field is not needed.	[out][optional][transfer none]
out_voice_class	return location for a MbimVoiceClass, or `NULL` if the 'VoiceClass' field is not needed.	[out][optional][transfer none]
out_sim_class	return location for a MbimSimClass, or `NULL` if the 'SimClass' field is not needed.	[out][optional][transfer none]
out_data_class	return location for a MbimDataClassV3, or `NULL` if the 'DataClass' field is not needed.	[out][optional][transfer none]
out_sms_caps	return location for a MbimSmsCaps, or `NULL` if the 'SmsCaps' field is not needed.	[out][optional][transfer none]
out_control_caps	return location for a MbimCtrlCaps, or `NULL` if the 'ControlCaps' field is not needed.	[out][optional][transfer none]
out_data_subclass	return location for a guint64, or `NULL` if the 'DataSubclass' field is not needed.	[out][optional][transfer none]
out_max_sessions	return location for a guint32, or `NULL` if the 'MaxSessions' field is not needed.	[out][optional][transfer none]
out_executor_index	return location for a guint32, or `NULL` if the 'ExecutorIndex' field is not needed.	[out][optional][transfer none]
out_wcdma_band_class	return location for a guint32, or `NULL` if the 'WcdmaBandClass' field is not needed.	[out][optional][transfer none]
out_lte_band_class_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_lte_band_class	return location for a newly allocated array of guint16 items, or `NULL` if the 'LteBandClass' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `g_free()`.	[out][optional][nullable][transfer full]
out_nr_band_class_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_nr_band_class	return location for a newly allocated array of guint16 items, or `NULL` if the 'NrBandClass' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `g_free()`.	[out][optional][nullable][transfer full]
out_custom_data_class	return location for a newly allocated string, or `NULL` if the 'CustomDataClass' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_device_id	return location for a newly allocated string, or `NULL` if the 'DeviceId' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_firmware_info	return location for a newly allocated string, or `NULL` if the 'FirmwareInfo' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_hardware_info	return location for a newly allocated string, or `NULL` if the 'HardwareInfo' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_modem_configuration_query_new ()

MbimMessage *
mbim_message_ms_basic_connect_extensions_v3_modem_configuration_query_new
                               (GError **error);

Create a new request for the 'Modem Configuration' query command in the 'Ms Basic Connect Extensions V3' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_modem_configuration_response_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_modem_configuration_response_parse
                               (const MbimMessage *message,
                                MbimModemConfigurationStatus *out_configuration_status,
                                gchar **out_configuration_name,
                                GList **out_unnamed_ies,
                                GError **error);

Parses and returns parameters of the 'Modem Configuration' response command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_configuration_status	return location for a MbimModemConfigurationStatus, or `NULL` if the 'ConfigurationStatus' field is not needed.	[out][optional][transfer none]
out_configuration_name	return location for a newly allocated string, or `NULL` if the 'ConfigurationName' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_unnamed_ies	return location for a newly allocated list of MbimTlv items, or `NULL` if the 'UnnamedIes' field is not needed. Free the returned value with `g_list_free_full()` using `mbim_tlv_unref()` as GDestroyNotify.	[out][optional][element-type MbimTlv][transfer full]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_modem_configuration_notification_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_modem_configuration_notification_parse
                               (const MbimMessage *message,
                                MbimModemConfigurationStatus *out_modem_configuration_status,
                                gchar **out_configuration_name,
                                GList **out_unnamed_ies,
                                GError **error);

Parses and returns parameters of the 'Modem Configuration' notification command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_modem_configuration_status	return location for a MbimModemConfigurationStatus, or `NULL` if the 'ModemConfigurationStatus' field is not needed.	[out][optional][transfer none]
out_configuration_name	return location for a newly allocated string, or `NULL` if the 'ConfigurationName' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_unnamed_ies	return location for a newly allocated list of MbimTlv items, or `NULL` if the 'UnnamedIes' field is not needed. Free the returned value with `g_list_free_full()` using `mbim_tlv_unref()` as GDestroyNotify.	[out][optional][element-type MbimTlv][transfer full]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_registration_parameters_query_new ()

MbimMessage *
mbim_message_ms_basic_connect_extensions_v3_registration_parameters_query_new
                               (GError **error);

Create a new request for the 'Registration Parameters' query command in the 'Ms Basic Connect Extensions V3' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_registration_parameters_set_new ()

MbimMessage *
mbim_message_ms_basic_connect_extensions_v3_registration_parameters_set_new
                               (MbimMicoMode mico_mode,
                                MbimDrxCycle drx_cycle,
                                MbimLadnInfo ladn_info,
                                MbimDefaultPduActivationHint default_pdu_activation_hint,
                                gboolean re_register_if_nedeed,
                                const GList *unnamed_ies,
                                GError **error);

Create a new request for the 'Registration Parameters' set command in the 'Ms Basic Connect Extensions V3' service.

Parameters

mico_mode	the 'MicoMode' field, given as a MbimMicoMode.	[in]
drx_cycle	the 'DrxCycle' field, given as a MbimDrxCycle.	[in]
ladn_info	the 'LadnInfo' field, given as a MbimLadnInfo.	[in]
default_pdu_activation_hint	the 'DefaultPduActivationHint' field, given as a MbimDefaultPduActivationHint.	[in]
re_register_if_nedeed	the 'ReRegisterIfNedeed' field, given as a gboolean.	[in]
unnamed_ies	the 'UnnamedIes' field, given as a list of # items.	[in][element-type MbimTlv][transfer none]
error	return location for error or `NULL`.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_registration_parameters_response_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_registration_parameters_response_parse
                               (const MbimMessage *message,
                                MbimMicoMode *out_mico_mode,
                                MbimDrxCycle *out_drx_cycle,
                                MbimLadnInfo *out_ladn_info,
                                MbimDefaultPduActivationHint *out_default_pdu_activation_hint,
                                gboolean *out_re_register_if_nedeed,
                                GList **out_unnamed_ies,
                                GError **error);

Parses and returns parameters of the 'Registration Parameters' response command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_mico_mode	return location for a MbimMicoMode, or `NULL` if the 'MicoMode' field is not needed.	[out][optional][transfer none]
out_drx_cycle	return location for a MbimDrxCycle, or `NULL` if the 'DrxCycle' field is not needed.	[out][optional][transfer none]
out_ladn_info	return location for a MbimLadnInfo, or `NULL` if the 'LadnInfo' field is not needed.	[out][optional][transfer none]
out_default_pdu_activation_hint	return location for a MbimDefaultPduActivationHint, or `NULL` if the 'DefaultPduActivationHint' field is not needed.	[out][optional][transfer none]
out_re_register_if_nedeed	return location for a gboolean, or `NULL` if the 'ReRegisterIfNedeed' field is not needed.	[out][optional][transfer none]
out_unnamed_ies	return location for a newly allocated list of MbimTlv items, or `NULL` if the 'UnnamedIes' field is not needed. Free the returned value with `g_list_free_full()` using `mbim_tlv_unref()` as GDestroyNotify.	[out][optional][element-type MbimTlv][transfer full]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_lte_attach_info_response_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_lte_attach_info_response_parse
                               (const MbimMessage *message,
                                MbimLteAttachState *out_lte_attach_state,
                                MbimNwError *out_nw_error,
                                MbimContextIpType *out_ip_type,
                                gchar **out_access_string,
                                gchar **out_user_name,
                                gchar **out_password,
                                MbimCompression *out_compression,
                                MbimAuthProtocol *out_auth_protocol,
                                GError **error);

Parses and returns parameters of the 'Lte Attach Info' response command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_lte_attach_state	return location for a MbimLteAttachState, or `NULL` if the 'LteAttachState' field is not needed.	[out][optional][transfer none]
out_nw_error	return location for a MbimNwError, or `NULL` if the 'NwError' field is not needed.	[out][optional][transfer none]
out_ip_type	return location for a MbimContextIpType, or `NULL` if the 'IpType' field is not needed.	[out][optional][transfer none]
out_access_string	return location for a newly allocated string, or `NULL` if the 'AccessString' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_user_name	return location for a newly allocated string, or `NULL` if the 'UserName' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_password	return location for a newly allocated string, or `NULL` if the 'Password' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_compression	return location for a MbimCompression, or `NULL` if the 'Compression' field is not needed.	[out][optional][transfer none]
out_auth_protocol	return location for a MbimAuthProtocol, or `NULL` if the 'AuthProtocol' field is not needed.	[out][optional][transfer none]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_lte_attach_info_notification_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_lte_attach_info_notification_parse
                               (const MbimMessage *message,
                                MbimLteAttachState *out_lte_attach_state,
                                MbimNwError *out_nw_error,
                                MbimContextIpType *out_ip_type,
                                gchar **out_access_string,
                                gchar **out_user_name,
                                gchar **out_password,
                                MbimCompression *out_compression,
                                MbimAuthProtocol *out_auth_protocol,
                                GError **error);

Parses and returns parameters of the 'Lte Attach Info' notification command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_lte_attach_state	return location for a MbimLteAttachState, or `NULL` if the 'LteAttachState' field is not needed.	[out][optional][transfer none]
out_nw_error	return location for a MbimNwError, or `NULL` if the 'NwError' field is not needed.	[out][optional][transfer none]
out_ip_type	return location for a MbimContextIpType, or `NULL` if the 'IpType' field is not needed.	[out][optional][transfer none]
out_access_string	return location for a newly allocated string, or `NULL` if the 'AccessString' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_user_name	return location for a newly allocated string, or `NULL` if the 'UserName' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_password	return location for a newly allocated string, or `NULL` if the 'Password' field is not needed. Free the returned value with `g_free()`.	[out][optional][transfer full]
out_compression	return location for a MbimCompression, or `NULL` if the 'Compression' field is not needed.	[out][optional][transfer none]
out_auth_protocol	return location for a MbimAuthProtocol, or `NULL` if the 'AuthProtocol' field is not needed.	[out][optional][transfer none]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_base_stations_info_query_new ()

MbimMessage *
mbim_message_ms_basic_connect_extensions_v3_base_stations_info_query_new
                               (guint32 max_gsm_count,
                                guint32 max_umts_count,
                                guint32 max_tdscdma_count,
                                guint32 max_lte_count,
                                guint32 max_cdma_count,
                                guint32 max_nr_count,
                                GError **error);

Create a new request for the 'Base Stations Info' query command in the 'Ms Basic Connect Extensions V3' service.

Parameters

max_gsm_count	the 'MaxGsmCount' field, given as a guint32.	[in]
max_umts_count	the 'MaxUmtsCount' field, given as a guint32.	[in]
max_tdscdma_count	the 'MaxTdscdmaCount' field, given as a guint32.	[in]
max_lte_count	the 'MaxLteCount' field, given as a guint32.	[in]
max_cdma_count	the 'MaxCdmaCount' field, given as a guint32.	[in]
max_nr_count	the 'MaxNrCount' field, given as a guint32.	[in]
error	return location for error or `NULL`.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_base_stations_info_response_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_base_stations_info_response_parse
                               (const MbimMessage *message,
                                MbimDataClassV3 *out_system_type,
                                MbimDataSubclass *out_system_sub_type,
                                MbimCellInfoServingGsm **out_gsm_serving_cell,
                                MbimCellInfoServingUmts **out_umts_serving_cell,
                                MbimCellInfoServingTdscdma **out_tdscdma_serving_cell,
                                MbimCellInfoServingLte **out_lte_serving_cell,
                                guint32 *out_gsm_neighboring_cells_count,
                                MbimCellInfoNeighboringGsmArray **out_gsm_neighboring_cells,
                                guint32 *out_umts_neighboring_cells_count,
                                MbimCellInfoNeighboringUmtsArray **out_umts_neighboring_cells,
                                guint32 *out_tdscdma_neighboring_cells_count,
                                MbimCellInfoNeighboringTdscdmaArray **out_tdscdma_neighboring_cells,
                                guint32 *out_lte_neighboring_cells_count,
                                MbimCellInfoNeighboringLteArray **out_lte_neighboring_cells,
                                guint32 *out_cdma_cells_count,
                                MbimCellInfoCdmaArray **out_cdma_cells,
                                guint32 *out_nr_serving_cells_count,
                                MbimCellInfoServingNrArray **out_nr_serving_cells,
                                guint32 *out_nr_neighbor_cells_count,
                                MbimCellInfoNeighboringNrArray **out_nr_neighbor_cells,
                                GError **error);

Parses and returns parameters of the 'Base Stations Info' response command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_system_type	return location for a MbimDataClassV3, or `NULL` if the 'SystemType' field is not needed.	[out][optional][transfer none]
out_system_sub_type	return location for a MbimDataSubclass, or `NULL` if the 'SystemSubType' field is not needed.	[out][optional][transfer none]
out_gsm_serving_cell	return location for a newly allocated MbimCellInfoServingGsm, or `NULL` if the 'GsmServingCell' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_serving_gsm_free()`.	[out][optional][nullable][transfer full]
out_umts_serving_cell	return location for a newly allocated MbimCellInfoServingUmts, or `NULL` if the 'UmtsServingCell' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_serving_umts_free()`.	[out][optional][nullable][transfer full]
out_tdscdma_serving_cell	return location for a newly allocated MbimCellInfoServingTdscdma, or `NULL` if the 'TdscdmaServingCell' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_serving_tdscdma_free()`.	[out][optional][nullable][transfer full]
out_lte_serving_cell	return location for a newly allocated MbimCellInfoServingLte, or `NULL` if the 'LteServingCell' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_serving_lte_free()`.	[out][optional][nullable][transfer full]
out_gsm_neighboring_cells_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_gsm_neighboring_cells	return location for a newly allocated array of MbimCellInfoNeighboringGsm items, or `NULL` if the 'GsmNeighboringCells' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_neighboring_gsm_array_free()`.	[out][optional][nullable][transfer full][array zero-terminated=1][element-type MbimCellInfoNeighboringGsm]
out_umts_neighboring_cells_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_umts_neighboring_cells	return location for a newly allocated array of MbimCellInfoNeighboringUmts items, or `NULL` if the 'UmtsNeighboringCells' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_neighboring_umts_array_free()`.	[out][optional][nullable][transfer full][array zero-terminated=1][element-type MbimCellInfoNeighboringUmts]
out_tdscdma_neighboring_cells_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_tdscdma_neighboring_cells	return location for a newly allocated array of MbimCellInfoNeighboringTdscdma items, or `NULL` if the 'TdscdmaNeighboringCells' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_neighboring_tdscdma_array_free()`.	[out][optional][nullable][transfer full][array zero-terminated=1][element-type MbimCellInfoNeighboringTdscdma]
out_lte_neighboring_cells_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_lte_neighboring_cells	return location for a newly allocated array of MbimCellInfoNeighboringLte items, or `NULL` if the 'LteNeighboringCells' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_neighboring_lte_array_free()`.	[out][optional][nullable][transfer full][array zero-terminated=1][element-type MbimCellInfoNeighboringLte]
out_cdma_cells_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_cdma_cells	return location for a newly allocated array of MbimCellInfoCdma items, or `NULL` if the 'CdmaCells' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_cdma_array_free()`.	[out][optional][nullable][transfer full][array zero-terminated=1][element-type MbimCellInfoCdma]
out_nr_serving_cells_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_nr_serving_cells	return location for a newly allocated array of MbimCellInfoServingNr items, or `NULL` if the 'NrServingCells' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_serving_nr_array_free()`.	[out][optional][nullable][transfer full][array zero-terminated=1][element-type MbimCellInfoServingNr]
out_nr_neighbor_cells_count	return location for a guint32, or `NULL` if the field is not needed.	[out][optional][transfer none]
out_nr_neighbor_cells	return location for a newly allocated array of MbimCellInfoNeighboringNr items, or `NULL` if the 'NrNeighborCells' field is not needed. The availability of this field is not always guaranteed, and therefore `NULL` may be given as a valid output. Free the returned value with `mbim_cell_info_neighboring_nr_array_free()`.	[out][optional][nullable][transfer full][array zero-terminated=1][element-type MbimCellInfoNeighboringNr]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_wake_reason_query_new ()

MbimMessage *
mbim_message_ms_basic_connect_extensions_v3_wake_reason_query_new
                               (GError **error);

Create a new request for the 'Wake Reason' query command in the 'Ms Basic Connect Extensions V3' service.

Parameters

error

return location for error or NULL.

Returns

a newly allocated MbimMessage, which should be freed with mbim_message_unref().

Since: 1.28

mbim_message_ms_basic_connect_extensions_v3_wake_reason_response_parse ()

gboolean
mbim_message_ms_basic_connect_extensions_v3_wake_reason_response_parse
                               (const MbimMessage *message,
                                MbimWakeType *out_wake_type,
                                guint32 *out_session_id,
                                MbimTlv **out_wake_tlv,
                                GError **error);

Parses and returns parameters of the 'Wake Reason' response command in the 'Ms Basic Connect Extensions V3' service.

Parameters

message	the MbimMessage.
out_wake_type	return location for a MbimWakeType, or `NULL` if the 'WakeType' field is not needed.	[out][optional][transfer none]
out_session_id	return location for a guint32, or `NULL` if the 'SessionId' field is not needed.	[out][optional][transfer none]
out_wake_tlv	return location for a newly allocated MbimTlv, or `NULL` if the 'WakeTlv' field is not needed. Free the returned value with `mbim_tlv_unref()`.	[out][optional][transfer full]
error	return location for error or `NULL`.

Returns

TRUE if the message was correctly parsed, FALSE if error is set.

Since: 1.28

Types and Values

MbimCellInfoServingNr

typedef struct {
    gchar *provider_id;
    guint64 nci;
    guint32 physical_cell_id;
    guint32 nrarfcn;
    guint32 tac;
    guint32 rsrp;
    guint32 rsrq;
    guint32 sinr;
    guint64 timing_advance;
} MbimCellInfoServingNr;

A MbimCellInfoServingNr element.

Members

gchar *`provider_id`;	a string.
guint64 `nci`;	a guint64.
guint32 `physical_cell_id`;	a guint32.
guint32 `nrarfcn`;	a guint32.
guint32 `tac`;	a guint32.
guint32 `rsrp`;	a guint32.
guint32 `rsrq`;	a guint32.
guint32 `sinr`;	a guint32.
guint64 `timing_advance`;	a guint64.

Since: 1.28

MbimCellInfoServingNrArray

typedef MbimCellInfoServingNr *MbimCellInfoServingNrArray;

A NULL-terminated array of MbimCellInfoServingNr elements.

Since: 1.28

MbimCellInfoNeighboringNr

typedef struct {
    guint32 system_sub_type;
    gchar *provider_id;
    gchar *cell_id;
    guint32 physical_cell_id;
    guint32 tac;
    guint32 rsrp;
    guint32 rsrq;
    guint32 sinr;
} MbimCellInfoNeighboringNr;

A MbimCellInfoNeighboringNr element.

Members

guint32 `system_sub_type`;	a MbimDataSubclass given as a guint32.
gchar *`provider_id`;	a string.
gchar *`cell_id`;	a string.
guint32 `physical_cell_id`;	a guint32.
guint32 `tac`;	a guint32.
guint32 `rsrp`;	a guint32.
guint32 `rsrq`;	a guint32.
guint32 `sinr`;	a guint32.

Since: 1.28

MbimCellInfoNeighboringNrArray

typedef MbimCellInfoNeighboringNr *MbimCellInfoNeighboringNrArray;

A NULL-terminated array of MbimCellInfoNeighboringNr elements.

Since: 1.28