NOT for review (for discussion): Query IOSurfaceIsInUse in the browser process

gpu/GLES2/extensions/CHROMIUM/CHROMIUM_schedule_ca_layer.txt

 Name
 
     CHROMIUM_schedule_ca_layer
 
 Name Strings
 
     GL_CHROMIUM_schedule_ca_layer
 
 Version
 
@@ skipping 69 matching lines @@
     32-bit ARGB value.
     <edge_aa_mask> is a bitfield specifying which of the edges of the layer are
     to have anti-aliasing.
     <bounds_rect> contains four values indicating the x, y, width, and height of
     the layer in pixels.
     <filter> will be used for both minification and magnification filtering. The
     only valid values are GL_LINEAR and GL_NEAREST.
 
     The command
 
-       glScheduleCALayerInUseQueryCHROMIUM(GLsizei count, GLuint* textures);
+       glScheduleCALayerInUseQueryCHROMIUM(
+           GLsizei count,
+           GLuint* textures_and_handle_requests);
 
-    schedules a query at the time of the next call to swap buffers. If the given
-    texture is backed by an IOSurface, then the query checks to see whether the
-    IOSurface is in use by the Window Server. Otherwise, the query returns
-    false. All the results will be returned with the swap ACK in
+    schedules a query at the time of the next call to swap buffers. 
+    <textures_and_handle_requests> contains an array of <count> pairs of
+    integers. The first value in each pair is a texture handle. The second value
+    either GL_TRUE or GL_FALSE indicating a request for a GpuMemoryBuffer
+    handle.
+    If the specified texture is backed by an IOSurface and a
+    GpuMemoryBufferHanlde is requested, then the handle will be returned along
+    with a boolean value indicating if the value of IOSurfaceIsInUse is
+    meaningful or not for that IOSurface. All of the results, regardless of
+    GpuMemoryBufferHandle requests will be returned with the swap ACK in
     GpuCommandBufferMsg_SwapBuffersCompleted_Params. Clients should not destroy
     any textures while they are being queried, as the swap ACK will use the
     original texture id to identify the queried textures.
 
 Errors
 
     GL_INVALID_OPERATION is generated when glScheduleCALayerCHROMIUM is called
     without a prior call to glScheduleCALayerSharedStateCHROMIUM.
 
 New State
 
     None.
 
 Revision History
 
+    11/3/2016    Add textures_and_handle_requests parameter.
     6/13/2016    Add glScheduleCALayerInUseQueryCHROMIUM.
     4/12/2016    Add a parameter to support minification and magnification
                  filtering.
     12/16/2015   Add clipping and edge anti-aliasing.
     11/7/2015    Initial checkin