| Index: ppapi/c/ppb_file_io.h
|
| ===================================================================
|
| --- ppapi/c/ppb_file_io.h (revision 113658)
|
| +++ ppapi/c/ppb_file_io.h (working copy)
|
| @@ -3,7 +3,7 @@
|
| * found in the LICENSE file.
|
| */
|
|
|
| -/* From ppb_file_io.idl modified Thu Dec 1 10:47:02 2011. */
|
| +/* From ppb_file_io.idl modified Mon Aug 29 10:11:34 2011. */
|
|
|
| #ifndef PPAPI_C_PPB_FILE_IO_H_
|
| #define PPAPI_C_PPB_FILE_IO_H_
|
| @@ -117,9 +117,8 @@
|
| int32_t open_flags,
|
| struct PP_CompletionCallback callback);
|
| /**
|
| - * Query() queries info about the file opened by this FileIO object. The
|
| - * FileIO object must be opened, and there must be no other operations
|
| - * pending.
|
| + * Query() queries info about the file opened by this FileIO object. This
|
| + * function will fail if the FileIO object has not been opened.
|
| *
|
| * @param[in] file_io A <code>PP_Resource</code> corresponding to a
|
| * FileIO.
|
| @@ -129,17 +128,13 @@
|
| * completion of Query().
|
| *
|
| * @return An int32_t containing an error code from <code>pp_errors.h</code>.
|
| - * PP_ERROR_FAILED will be returned if the file isn't opened, and
|
| - * PP_ERROR_INPROGRESS will be returned if there is another operation pending.
|
| */
|
| int32_t (*Query)(PP_Resource file_io,
|
| struct PP_FileInfo* info,
|
| struct PP_CompletionCallback callback);
|
| /**
|
| * Touch() Updates time stamps for the file opened by this FileIO object.
|
| - * This function will fail if the FileIO object has not been opened. The
|
| - * FileIO object must be opened, and there must be no other operations
|
| - * pending.
|
| + * This function will fail if the FileIO object has not been opened.
|
| *
|
| * @param[in] file_io A <code>PP_Resource</code> corresponding to a file
|
| * FileIO.
|
| @@ -149,8 +144,6 @@
|
| * completion of Touch().
|
| *
|
| * @return An int32_t containing an error code from <code>pp_errors.h</code>.
|
| - * PP_ERROR_FAILED will be returned if the file isn't opened, and
|
| - * PP_ERROR_INPROGRESS will be returned if there is another operation pending.
|
| */
|
| int32_t (*Touch)(PP_Resource file_io,
|
| PP_Time last_access_time,
|
| @@ -173,8 +166,7 @@
|
| * @return An The number of bytes read an error code from
|
| * <code>pp_errors.h</code>. If the return value is 0, then end-of-file was
|
| * reached. It is valid to call Read() multiple times with a completion
|
| - * callback to queue up parallel reads from the file, but pending reads
|
| - * cannot be interleaved with other operations.
|
| + * callback to queue up parallel reads from the file at different offsets.
|
| */
|
| int32_t (*Read)(PP_Resource file_io,
|
| int64_t offset,
|
| @@ -197,8 +189,7 @@
|
| * @return An The number of bytes written or an error code from
|
| * <code>pp_errors.h</code>. If the return value is 0, then end-of-file was
|
| * reached. It is valid to call Write() multiple times with a completion
|
| - * callback to queue up parallel writes to the file, but pending writes
|
| - * cannot be interleaved with other operations.
|
| + * callback to queue up parallel writes to the file at different offsets.
|
| */
|
| int32_t (*Write)(PP_Resource file_io,
|
| int64_t offset,
|
| @@ -207,9 +198,8 @@
|
| struct PP_CompletionCallback callback);
|
| /**
|
| * SetLength() sets the length of the file. If the file size is extended,
|
| - * then the extended area of the file is zero-filled. The FileIO object must
|
| - * have been opened with write access and there must be no other operations
|
| - * pending.
|
| + * then the extended area of the file is zero-filled. The FileIO object must
|
| + * have been opened with write access.
|
| *
|
| * @param[in] file_io A <code>PP_Resource</code> corresponding to a file
|
| * FileIO.
|
| @@ -218,16 +208,12 @@
|
| * completion of SetLength().
|
| *
|
| * @return An int32_t containing an error code from <code>pp_errors.h</code>.
|
| - * PP_ERROR_FAILED will be returned if the file isn't opened, and
|
| - * PP_ERROR_INPROGRESS will be returned if there is another operation pending.
|
| */
|
| int32_t (*SetLength)(PP_Resource file_io,
|
| int64_t length,
|
| struct PP_CompletionCallback callback);
|
| /**
|
| - * Flush() flushes changes to disk. This call can be very expensive! The
|
| - * FileIO object must have been opened with write access and there must be no
|
| - * other operations pending.
|
| + * Flush() flushes changes to disk. This call can be very expensive!
|
| *
|
| * @param[in] file_io A <code>PP_Resource</code> corresponding to a file
|
| * FileIO.
|
| @@ -235,8 +221,6 @@
|
| * completion of Flush().
|
| *
|
| * @return An int32_t containing an error code from <code>pp_errors.h</code>.
|
| - * PP_ERROR_FAILED will be returned if the file isn't opened, and
|
| - * PP_ERROR_INPROGRESS will be returned if there is another operation pending.
|
| */
|
| int32_t (*Flush)(PP_Resource file_io, struct PP_CompletionCallback callback);
|
| /**
|
|
|