Mojo: More data pipe implementation.

mojo/public/system/core.h

 // Copyright 2013 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 MOJO_PUBLIC_SYSTEM_CORE_H_
 #define MOJO_PUBLIC_SYSTEM_CORE_H_
 
 // Note: This header should be compilable as C.
 
 #include <stdint.h>
@@ skipping 388 matching lines @@
                                               uint32_t* num_bytes,
                                               MojoHandle* handles,
                                               uint32_t* num_handles,
                                               MojoReadMessageFlags flags);
 
 // Data pipe:
 // TODO(vtl): Moar docs.
 
 MOJO_SYSTEM_EXPORT MojoResult MojoCreateDataPipe(
     const struct MojoCreateDataPipeOptions* options,
-    MojoHandle* producer_handle,
-    MojoHandle* consumer_handle);
+    MojoHandle* data_pipe_producer_handle,
+    MojoHandle* data_pipe_consumer_handle);
 
 MOJO_SYSTEM_EXPORT MojoResult MojoWriteData(
     MojoHandle data_pipe_producer_handle,
     const void* elements,
     uint32_t* num_elements,
     MojoWriteDataFlags flags);
 
+// TODO(vtl): Note to self: |buffer_num_elements| is an "in-out" parameter:
+// on the "in" side, |*buffer_num_elements| is the number requested; on success,
+// on the "out" side, it's the number available (which may be GREATER or LESS
+// than the number requested; if the "all-or-nothing" flag is set, it's AT LEAST
+// the number requested).
 MOJO_SYSTEM_EXPORT MojoResult MojoBeginWriteData(
     MojoHandle data_pipe_producer_handle,
     void** buffer,
     uint32_t* buffer_num_elements,
     MojoWriteDataFlags flags);
 
 MOJO_SYSTEM_EXPORT MojoResult MojoEndWriteData(
     MojoHandle data_pipe_producer_handle,
     uint32_t num_elements_written);
 
@@ skipping 11 matching lines @@
 
 MOJO_SYSTEM_EXPORT MojoResult MojoEndReadData(
     MojoHandle data_pipe_consumer_handle,
     uint32_t num_elements_read);
 
 #ifdef __cplusplus
 }  // extern "C"
 #endif
 
 #endif  // MOJO_PUBLIC_SYSTEM_CORE_H_