qcacld-3.0: Correctly document wma_tx_packet()

Currently the prototype and the implementation of wma_tx_packet() use
different identifiers for some of the parameters, which is confusing
to both programmers and to tools. In addition currently the
implementation is documented instead of the interface. Therefore move
the documentation to the header file, and changed the prototype to
match the implementation.

Change-Id: I2c2e36c5b85935c37271336970c6532495c20fa6
CRs-Fixed: 2364268

core/wma/inc/wma_types.h

@@ -694,16 +694,32 @@ wma_ds_peek_rx_packet_info
 
 void wma_tx_abort(uint8_t vdev_id);
 
-QDF_STATUS wma_tx_packet(void *pWMA,
-			 void *pFrmBuf,
-			 uint16_t frmLen,
-			 eFrameType frmType,
-			 eFrameTxDir txDir,
-			 uint8_t tid,
-			 wma_tx_dwnld_comp_callback pCompFunc,
+/**
+ * wma_tx_packet() - Sends Tx Frame to TxRx
+ * @wma_context: wma context
+ * @tx_frame: frame buffer
+ * @frmLen: frame length
+ * @frmType: frame type
+ * @txDir: tx diection
+ * @tid: TID
+ * @tx_frm_download_comp_cb: tx download callback handler
+ * @tx_frm_ota_comp_cb: OTA complition handler
+ * @tx_flag: tx flag
+ * @vdev_id: vdev id
+ * @tdlsFlag: tdls flag
+ *
+ * This function sends the frame corresponding to the
+ * given vdev id.
+ * This is blocking call till the downloading of frame is complete.
+ *
+ * Return: QDF status
+ */
+QDF_STATUS wma_tx_packet(void *wma_context, void *tx_frame, uint16_t frmLen,
+			 eFrameType frmType, eFrameTxDir txDir, uint8_t tid,
+			 wma_tx_dwnld_comp_callback tx_frm_download_comp_cb,
 			 void *pData,
-			 wma_tx_ota_comp_callback pAckTxComp,
-			 uint8_t txFlag, uint8_t sessionId, bool tdlsflag,
+			 wma_tx_ota_comp_callback tx_frm_ota_comp_cb,
+			 uint8_t tx_flag, uint8_t vdev_id, bool tdlsFlag,
 			 uint16_t channel_freq, enum rateid rid);
 
 /**

core/wma/src/wma_data.c

@@ -2350,26 +2350,6 @@ static void wma_update_tx_send_params(struct tx_send_params *tx_param,
 		     tx_param->preamble_type);
 }
 
-/**
- * wma_tx_packet() - Sends Tx Frame to TxRx
- * @wma_context: wma context
- * @tx_frame: frame buffer
- * @frmLen: frame length
- * @frmType: frame type
- * @txDir: tx diection
- * @tid: TID
- * @tx_frm_download_comp_cb: tx download callback handler
- * @tx_frm_ota_comp_cb: OTA complition handler
- * @tx_flag: tx flag
- * @vdev_id: vdev id
- * @tdlsFlag: tdls flag
- *
- * This function sends the frame corresponding to the
- * given vdev id.
- * This is blocking call till the downloading of frame is complete.
- *
- * Return: QDF status
- */
 QDF_STATUS wma_tx_packet(void *wma_context, void *tx_frame, uint16_t frmLen,
 			 eFrameType frmType, eFrameTxDir txDir, uint8_t tid,
 			 wma_tx_dwnld_comp_callback tx_frm_download_comp_cb,