Implements CaptureDevice in the PortAudio DataSource used as a capture device.

src/net/java/sip/communicator/impl/media/protocol/portaudio/DataSource.java

@@ -7,17 +7,21 @@
 package net.java.sip.communicator.impl.media.protocol.portaudio;
 
 import java.io.*;
+import java.util.*;
 
 import javax.media.*;
+import javax.media.control.*;
 import javax.media.protocol.*;
 
 /**
- * Portaudio datasource.
+ * Implements <tt>DataSource</tt> and <tt>CaptureDevice</tt> for PortAudio.
  *
  * @author Damian Minkov
+ * @author Lubomir Marinov
  */
 public class DataSource
     extends PullBufferDataSource
+    implements CaptureDevice
 {
     private boolean connected = false;
 
@@ -71,6 +75,31 @@ public void disconnect()
         connected = false;
     }
 
+    /**
+     * Gets the <tt>CaptureDeviceInfo</tt> that describes this
+     * <tt>CaptureDevice</tt>.
+     *
+     * @return the <tt>CaptureDeviceInfo</tt> that describes this
+     * <tt>CaptureDevice</tt>
+     */
+    public CaptureDeviceInfo getCaptureDeviceInfo()
+    {
+        /*
+         * TODO The implemented search for the CaptureDeviceInfo of this
+         * CaptureDevice by looking for its MediaLocator is inefficient.
+         */
+        @SuppressWarnings("unchecked")
+        Vector<CaptureDeviceInfo> captureDeviceInfos
+            = (Vector<CaptureDeviceInfo>)
+                CaptureDeviceManager.getDeviceList(null);
+        MediaLocator locator = getLocator();
+
+        for (CaptureDeviceInfo captureDeviceInfo : captureDeviceInfos)
+            if (captureDeviceInfo.getLocator().equals(locator))
+                return captureDeviceInfo;
+        return null;
+    }
+
     /**
      * Tell we are a raw datasource
      *
@@ -124,6 +153,26 @@ public Time getDuration()
         return DURATION_UNKNOWN;
     }
 
+    /**
+     * Gets an array of <tt>FormatControl</tt> instances each one of which can
+     * be used before {@link #connect()} to get and set the capture
+     * <tt>Format</tt> of each one of the capture streams.
+     *
+     * @return an array of <tt>FormatControl</tt> instances each one of which
+     * can be used before {@link #connect()} to get and set the capture
+     * <tt>Format</tt> of each one of the capture streams
+     */
+    public FormatControl[] getFormatControls()
+    {
+        // TODO Make getControls() actually return a FormatControl instance.
+        List<FormatControl> formatControls = new ArrayList<FormatControl>();
+
+        for (Object control : getControls())
+            if (control instanceof FormatControl)
+                formatControls.add((FormatControl) control);
+        return formatControls.toArray(new FormatControl[formatControls.size()]);
+    }
+
     /**
      * Returns an array of PullBufferStream containing all the streams
      * i.e. only one in our case : only sound.