qcacld-3.0: (Part-2) Refactor open and close session logic in SAP module

Current open and close session APIs mainly defined in HDD, SME, and SAP
modules are not proper. They require some design changes to maintain the
consistency.

In order to achieve the goal of making symmetrical design for open and
close session logic, refactor existing API in SAP module.

CRs-Fixed: 2147969
Change-Id: Iccc5ddd2b14ec2b27e6746a211edd10ec06ad434

core/sap/inc/sap_api.h

@@ -785,13 +785,33 @@ typedef struct {
  *
  * struct sap_context is used to share per-BSS context between SAP and
  * its clients. A context is generated by sap_create_ctx() and is
- * destroyed by wlansap_close(). During the lifetime of the BSS the
+ * destroyed by sap_destroy_ctx(). During the lifetime of the BSS the
  * SAP context is passed as the primary parameter to SAP APIs. Note
  * that by design the contents of the structure are opaque to the
  * clients and a SAP context pointer must only be dereferenced by SAP.
  */
 struct sap_context;
 
+/**
+ * wlansap_roam_callback() - API to get the events for SAP persona
+ * @pContext: sap context
+ * @pCsrRoamInfo: pointer to SME CSR roam info structure
+ * @roamId: roam id being used
+ * @roamStatus: status of the event reported by SME to SAP
+ * @roamResult: result of the event reported by SME to SAP
+ *
+ * Any activity like start_bss, stop_bss, and etc for SAP persona
+ * happens, SME reports the result of those events to SAP through this
+ * callback.
+ *
+ * Return: QDF_STATUS based on overall result
+ */
+QDF_STATUS wlansap_roam_callback(void *pContext,
+				 struct csr_roam_info *pCsrRoamInfo,
+				 uint32_t roamId,
+				 eRoamCmdStatus roamStatus,
+				 eCsrRoamResult roamResult);
+
 /**
  * sap_create_ctx() - API to create the sap context
  *