PPAPI: Move PPB_DirectoryReader_Dev to stable (won't commit)

ppapi/api/ppb_directory_reader.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_DirectoryReader</code> interface.
+ */
+
+label Chrome {
+  M28 = 1.0
+};
+
+/**
+ * The <code>PP_DirectoryEntry</code> struct represents information about a
+ * directory entry.
+ */
+[assert_size(8)]
+struct PP_DirectoryEntry {
+  PP_Resource file_ref;
+  PP_FileType file_type;
+};
+
+/**
+ * The <code>PPB_DirectoryReader</code> interface provides a function to read
+ * entries in a directory.
+ */
+interface PPB_DirectoryReader {
+  /**
+   * Creates a DirectoryReader for the given directory.  Upon success, the
+   * corresponding directory is classified as "in use" by the resulting
+   * DirectoryReader object until such time as the DirectoryReader object is
+   * destroyed.
+   */
+  PP_Resource Create([in] PP_Resource directory_ref);
+
+  /**
+   * Returns PP_TRUE if the given resource is a DirectoryReader. Returns
+   * PP_FALSE if the resource is invalid or some type other than a
+   * DirectoryReader.
+   */
+  PP_Bool IsDirectoryReader([in] PP_Resource resource);
+
+  /**
+   * Reads all entries in the directory.
+   *
+   * @param[in] directory_reader A <code>PP_Resource</code>
+   * corresponding to a directory reader resource.
+   * @param[in] output An output array which will receive
+   * <code>PP_DirectoryEntry</code> objects on success.
+   * @param[in] callback A <code>PP_CompletionCallback</code> to run on
+   * completion.
+   *
+   * @return An error code from <code>pp_errors.h</code>.
+   */
+  int32_t ReadEntries([in] PP_Resource directory_reader,
+                      [in] PP_ArrayOutput output,
+                      [in] PP_CompletionCallback callback);
+};