Surface the noise estimate of the NS to be used by other components

webrtc/modules/audio_processing/ns/noise_suppression_x.h

 /*
  *  Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
  *
  *  Use of this source code is governed by a BSD-style license
  *  that can be found in the LICENSE file in the root of the source
  *  tree. An additional intellectual property rights grant can be found
  *  in the file PATENTS.  All contributing project authors may
  *  be found in the AUTHORS file in the root of the source tree.
  */
 
 #ifndef WEBRTC_MODULES_AUDIO_PROCESSING_NS_NOISE_SUPPRESSION_X_H_
 #define WEBRTC_MODULES_AUDIO_PROCESSING_NS_NOISE_SUPPRESSION_X_H_
 
+#include <stddef.h>
+
 #include "webrtc/typedefs.h"
 
 typedef struct NsxHandleT NsxHandle;
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 /*
  * This function creates an instance of the fixed point Noise Suppression.
@@ skipping 50 matching lines @@
  *
  * Output:
  *      - nsxInst       : Updated NSx instance
  *      - outFrame      : Pointer to output frame for each band
  */
 void WebRtcNsx_Process(NsxHandle* nsxInst,
                        const short* const* speechFrame,
                        int num_bands,
                        short* const* outFrame);
 
+/* Returns a pointer to the noise estimate per frequency bin. The number of
+ * frequency bins can be provided using WebRtcNsx_num_freq().
+ *
+ * Input
+ *      - nsxInst       : NSx instance. Needs to be initiated before call.
+ *
+ * Return value         : Pointer to the noise estimate per frequency bin.
+ *                        Returns NULL if the input is a NULL pointer or an
+ *                        uninitialized instance.
+ */
+const uint32_t* WebRtcNsx_noise_estimate(const NsxHandle* nsxInst);
+
+/* Returns the number of frequency bins, which is the length of the noise
+ * estimate for example.
+ *
+ * Return value         : Number of frequency bins.
+ */
+size_t WebRtcNsx_num_freq();
+
 #ifdef __cplusplus
 }
 #endif
 
 #endif  // WEBRTC_MODULES_AUDIO_PROCESSING_NS_NOISE_SUPPRESSION_X_H_