Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(853)

Side by Side Diff: ppapi/api/pp_completion_callback.idl

Issue 13238002: [PPAPI] Documentation fixes. (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: Created 7 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
« no previous file with comments | « no previous file | ppapi/api/ppb_message_loop.idl » ('j') | ppapi/api/ppb_message_loop.idl » ('J')
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 * Use of this source code is governed by a BSD-style license that can be 2 * Use of this source code is governed by a BSD-style license that can be
3 * found in the LICENSE file. 3 * found in the LICENSE file.
4 */ 4 */
5 5
6 /** 6 /**
7 * This file defines the API to create and run a callback. 7 * This file defines the API to create and run a callback.
8 */ 8 */
9 9
10 /** 10 /**
(...skipping 48 matching lines...) Expand 10 before | Expand all | Expand 10 after
59 }; 59 };
60 60
61 61
62 /** 62 /**
63 * <code>PP_CompletionCallback</code> is a common mechanism for supporting 63 * <code>PP_CompletionCallback</code> is a common mechanism for supporting
64 * potentially asynchronous calls in browser interfaces. Any method that takes a 64 * potentially asynchronous calls in browser interfaces. Any method that takes a
65 * <code>PP_CompletionCallback</code> can be used in one of three different 65 * <code>PP_CompletionCallback</code> can be used in one of three different
66 * ways: 66 * ways:
67 * - Required: The callback will always be invoked asynchronously on the 67 * - Required: The callback will always be invoked asynchronously on the
68 * thread where the associated PPB method was invoked. The method 68 * thread where the associated PPB method was invoked. The method
69 * will always return <code>PP_OK_COMPLETIONPENDING</code> when a 69 * will always return PP_OK_COMPLETIONPENDING when a required
70 * required callback, and the callback will be invoked later 70 * callback, and the callback will be invoked later (barring
71 * (barring system or thread shutdown; see PPB_MessageLoop for 71 * system or thread shutdown; see PPB_MessageLoop for details).
72 * details). Required callbacks are the default. 72 * Required callbacks are the default.
73 * 73 *
74 * NOTE: If you use a required callback on a background thread, 74 * NOTE: If you use a required callback on a background thread,
75 * you must have created and attached a PPB_MessageLoop. 75 * you must have created and attached a PPB_MessageLoop.
76 * Otherwise, the system can not run your callback on that thread, 76 * Otherwise, the system can not run your callback on that thread,
77 * and will instead emit a log message and crash your plugin to 77 * and will instead emit a log message and crash your plugin to
78 * make the problem more obvious. 78 * make the problem more obvious.
79 * 79 *
80 * - Optional: The callback may be invoked asynchronously, or the PPB method 80 * - Optional: The callback may be invoked asynchronously, or the PPB method
81 * may complete synchronously if it can do so without blocking. 81 * may complete synchronously if it can do so without blocking.
82 * If the method will complete asynchronously, it will return 82 * If the method will complete asynchronously, it will return
(...skipping 170 matching lines...) Expand 10 before | Expand all | Expand 10 after
253 struct PP_CompletionCallback temp = *cc; 253 struct PP_CompletionCallback temp = *cc;
254 *cc = PP_BlockUntilComplete(); 254 *cc = PP_BlockUntilComplete();
255 PP_RunCompletionCallback(&temp, res); 255 PP_RunCompletionCallback(&temp, res);
256 } 256 }
257 /** 257 /**
258 * @} 258 * @}
259 */ 259 */
260 260
261 #endinl 261 #endinl
262 262
OLDNEW
« no previous file with comments | « no previous file | ppapi/api/ppb_message_loop.idl » ('j') | ppapi/api/ppb_message_loop.idl » ('J')

Powered by Google App Engine
This is Rietveld 408576698