diff options
Diffstat (limited to 'ppapi/c/ppb_file_io.h')
| -rw-r--r-- | ppapi/c/ppb_file_io.h | 34 |
1 files changed, 9 insertions, 25 deletions
diff --git a/ppapi/c/ppb_file_io.h b/ppapi/c/ppb_file_io.h index aa028b1..333984b 100644 --- a/ppapi/c/ppb_file_io.h +++ b/ppapi/c/ppb_file_io.h @@ -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 @@ struct PPB_FileIO { 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 @@ struct PPB_FileIO { * 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 @@ struct PPB_FileIO { * 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 @@ struct PPB_FileIO { * @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 @@ struct PPB_FileIO { * @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 PPB_FileIO { 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 @@ struct PPB_FileIO { * 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 @@ struct PPB_FileIO { * 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); /** |