bt_cap_handover_cb Struct Reference

Callback structure for CAP procedures. More...

#include <zephyr/bluetooth/audio/cap.h>

Data Fields
void(*	unicast_to_broadcast_created )(struct bt_cap_broadcast_source *broadcast_source)
	The broadcast source has been created for handover.
void(*	unicast_to_broadcast_complete )(int err, struct bt_conn *conn, struct bt_cap_unicast_group *unicast_group, struct bt_cap_broadcast_source *broadcast_source)
	The unicast to broadcast handover procedure has finished.
void(*	broadcast_to_unicast_complete )(int err, struct bt_conn *conn, struct bt_cap_broadcast_source *broadcast_source, struct bt_cap_unicast_group *unicast_group)
	The broadcast to unicast handover procedure has finished.

Detailed Description

Callback structure for CAP procedures.

Field Documentation

broadcast_to_unicast_complete

void(* bt_cap_handover_cb::broadcast_to_unicast_complete) (int err, struct bt_conn *conn, struct bt_cap_broadcast_source *broadcast_source, struct bt_cap_unicast_group *unicast_group)

The broadcast to unicast handover procedure has finished.

Parameters

err	0 if success else a negative errno value.
conn	Pointer to the connection where the error occurred or NULL if local failure.
broadcast_source	NULL if the broadcast sourced was deleted during the procedure, else pointer to the broadcast sourced provided in the parameters.
unicast_group	Pointer to newly created unicast group, or NULL in case of an error happening before it was created.

unicast_to_broadcast_complete

void(* bt_cap_handover_cb::unicast_to_broadcast_complete) (int err, struct bt_conn *conn, struct bt_cap_unicast_group *unicast_group, struct bt_cap_broadcast_source *broadcast_source)

The unicast to broadcast handover procedure has finished.

Parameters

err	0 if success else a negative errno value.
conn	Pointer to the connection where the error occurred or NULL if local failure.
unicast_group	NULL if the unicast group was deleted during the procedure, else pointer to the unicast group provided in the parameters.
broadcast_source	Pointer to newly created broadcast source, or NULL in case of an error happening before it was created.

unicast_to_broadcast_created

void(* bt_cap_handover_cb::unicast_to_broadcast_created) (struct bt_cap_broadcast_source *broadcast_source)

The broadcast source has been created for handover.

When this is called, the broadcast source has been created and the BASE can be generated by bt_cap_initiator_broadcast_get_base(). To continue with the broadcast reception part of the procedure, the application shall enable extended and periodic advertising and set the BASE in the periodic advertising data with bt_le_per_adv_set_data(). The procedure will finish once the CAP acceptors have synced to the newly created broadcast source.

Parameters

broadcast_source

Pointer to newly created broadcast source.

---

The documentation for this struct was generated from the following file:

• zephyr/bluetooth/audio/cap.h