Introduce PPB_AudioInput_Dev v0.3 and refactor the device enumeration code:

ppapi/api/dev/ppb_audio_input_dev.idl

 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 /**
  * This file defines the <code>PPB_AudioInput_Dev</code> interface, which
  * provides realtime audio input capture.
  */
 
 label Chrome {
-  M19 = 0.2
+  M19 = 0.2,
+  M25 = 0.3
 };
 
 /**
  * <code>PPB_AudioInput_Callback</code> defines the type of an audio callback
  * function used to provide the audio buffer with data. This callback will be
  * called on a separate thread from the creation thread.
  */
 typedef void PPB_AudioInput_Callback([in] mem_t sample_buffer,
                                      [in] uint32_t buffer_size_in_bytes,
                                      [inout] mem_t user_data);
@@ skipping 49 matching lines @@
    * - <code>devices</code> must be valid until <code>callback</code> is called,
    *   if the method returns <code>PP_OK_COMPLETIONPENDING</code>;
    * - the ref count of the returned <code>devices</code> has already been
    *   increased by 1 for the caller.
    *
    * @param[in] audio_input A <code>PP_Resource</code> corresponding to an audio
    * input resource.
    * @param[out] devices Once the operation is completed successfully,
    * <code>devices</code> will be set to a <code>PPB_ResourceArray_Dev</code>
    * resource, which holds a list of <code>PPB_DeviceRef_Dev</code> resources.
-   * @param[in] callback  A <code>PP_CompletionCallback</code> to run on
+   * @param[in] callback A <code>PP_CompletionCallback</code> to run on
    * completion.
    *
    * @return An error code from <code>pp_errors.h</code>.
    */
+  [deprecate=0.3]
   int32_t EnumerateDevices(
       [in] PP_Resource audio_input,
       [out] PP_Resource devices,
       [in] PP_CompletionCallback callback);
 
   /**
+   * Enumerates audio input devices.
+   *
+   * @param[in] audio_input A <code>PP_Resource</code> corresponding to an audio
+   * input resource.
+   * @param[in] output An output array which will receive
+   * <code>PPB_DeviceRef_Dev</code> resources on success. Please note that the
+   * ref count of those resources has already been increased by 1 for the
+   * caller.
+   * @param[in] callback A <code>PP_CompletionCallback</code> to run on
+   * completion.
+   *
+   * @return An error code from <code>pp_errors.h</code>.
+   */
+  [version=0.3]
+  int32_t EnumerateDevices(
+      [in] PP_Resource audio_input,
+      [in] PP_ArrayOutput output,
+      [in] PP_CompletionCallback callback);
+
+  /**
+   * Requests device change notifications.
+   *
+   * @param[in] audio_input A <code>PP_Resource</code> corresponding to an audio
+   * input resource.
+   * @param[in] callback The callback to receive notifications. If not NULL, it
+   * will be called once for the currently available devices, and then every
+   * time the list of available devices changes. All calls will happen on the
+   * same thread as the one on which MonitorDeviceChange() is called. It will
+   * receive notifications until <code>audio_input</code> is destroyed or
+   * <code>MonitorDeviceChange()</code> is called to set a new callback for
+   * <code>audio_input</code>. You can pass NULL to cancel sending
+   * notifications.
+   * @param[inout] user_data An opaque pointer that will be passed to
+   * <code>callback</code>.
+   *
+   * @return An error code from <code>pp_errors.h</code>.
+   */
+  [version=0.3]
+  int32_t MonitorDeviceChange(
+      [in] PP_Resource audio_input,
+      [in] PP_MonitorDeviceChangeCallback callback,
+      [inout] mem_t user_data);
+
+  /**
    * Opens an audio input device. No sound will be captured until
    * StartCapture() is called.
    *
    * @param[in] audio_input A <code>PP_Resource</code> corresponding to an audio
    * input resource.
    * @param[in] device_ref Identifies an audio input device. It could be one of
    * the resource in the array returned by EnumerateDevices(), or 0 which means
    * the default device.
    * @param[in] config A <code>PPB_AudioConfig</code> audio configuration
    * resource.
@@ skipping 60 matching lines @@
    * not valid to call Open() again after a call to this method.
    * If an audio input resource is destroyed while a device is still open, then
    * it will be implicitly closed, so you are not required to call this method.
    *
    * @param[in] audio_input A <code>PP_Resource</code> corresponding to an audio
    * input resource.
    */
   void Close(
       [in] PP_Resource audio_input);
 };