Cleanup...

ppapi/c/dev/ppb_audio_trusted_dev.h

 // Copyright (c) 2010 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.
 
 #ifndef PPAPI_C_DEV_PPB_AUDIO_TRUSTED_DEV_H_
 #define PPAPI_C_DEV_PPB_AUDIO_TRUSTED_DEV_H_
 
 #include "ppapi/c/pp_completion_callback.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_resource.h"
 
 #define PPB_AUDIO_TRUSTED_DEV_INTERFACE "PPB_AudioTrusted(Dev);0.2"
 
-// This interface is to be used by proxy implementations.  All
-// functions should be called from the main thread only.  The
-// resource returned is an Audio resource; most of the PPB_Audio_Dev
-// interface is also usable on this resource.
+/**
+ * This interface is to be used by proxy implementations.  All
+ * functions should be called from the main thread only.  The
+ * resource returned is an Audio resource; most of the PPB_Audio_Dev
+ * interface is also usable on this resource.
+ */
 struct PPB_AudioTrusted_Dev {
-  // Returns an audio resource.
+  /** Returns an audio resource. */
   PP_Resource (*CreateTrusted)(PP_Instance instance);
 
-  // Opens a paused audio interface, used by trusted side of proxy.
-  // Returns PP_ERROR_WOULD_BLOCK on success, and invokes
-  // the |create_callback| asynchronously to complete.
-  // As this function should always be invoked from the main thread,
-  // do not use the blocking variant of PP_CompletionCallback.
+  /**
+   * Opens a paused audio interface, used by trusted side of proxy.
+   * Returns PP_ERROR_WOULD_BLOCK on success, and invokes
+   * the |create_callback| asynchronously to complete.
+   * As this function should always be invoked from the main thread,
+   * do not use the blocking variant of PP_CompletionCallback.
+   */
   int32_t (*Open)(PP_Resource audio, PP_Resource config,
                   struct PP_CompletionCallback create_callback);
 
-  // Get the sync socket.  Use once Open has completed.
-  // Returns PP_OK on success.
+  /**
+   * Get the sync socket.  Use once Open has completed.
+   * Returns PP_OK on success.
+   */
   int32_t (*GetSyncSocket)(PP_Resource audio, int* sync_socket);
 
-  // Get the shared memory interface.  Use once Open has completed.
-  // Returns PP_OK on success.
+  /**
+   * Get the shared memory interface.  Use once Open has completed.
+   * Returns PP_OK on success.
+   */
   int32_t (*GetSharedMemory)(PP_Resource audio,
                              int* shm_handle,
-                             int32_t* shm_size);
+                             uint32_t* shm_size);
 };
 
 #endif  // PPAPI_C_DEV_PPB_AUDIO_TRUSTED_DEV_H_