glQueryCounter - record the GL time into a query object after all previous commands have reached the GL

voidglQueryCounter(GLuintid,GLenumtarget);

       Copyright © 2010-2014 Khronos Group

[FIXME: source]                                    11/18/2024                                 GLQUERYCOUNTER(3G)

glQueryCounter causes the GL to record the current time into the query object named id.  target must be
       GL_TIMESTAMP. The time is recorded after all previous commands on the GL client and server state and the
       framebuffer have been fully realized. When the time is recorded, the query result for that object is
       marked available.  glQueryCounter timer queries can be used within a glBeginQuery() /

       glEndQuery block where the target is GL_TIME_ELAPSED and it does not affect the result of that query
       object.

GL_INVALID_OPERATION is generated if id is the name of a query object that is already in use within a
       glBeginQuery() /

       glEndQuery block.

       GL_INVALID_VALUE is generated if id is not the name of a query object returned from a previous call to
       glGenQueries().

       GL_INVALID_ENUM is generated if target is not GL_TIMESTAMP.

       glQueryCounter - record the GL time into a query object after all previous commands have reached the GL
       server but have not yet necessarily executed.

glQueryCounter is available only if the GL version is 3.3 or higher.

id
           Specify the name of a query object into which to record the GL time.

       target
           Specify the counter to query.  target must be GL_TIMESTAMP.

glGenQueries(), glBeginQuery(),

       glEndQuery, glDeleteQueries(), glGetQueryObject(), glGetQueryiv(), glGet()

       ┌────────────────┬───────────────────────────────────────────────────────────────────────┐
       │                │                OpenGLVersion                                         │
       ├────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
       │ Function       │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
       │ /              │     │     │     │     │     │     │     │     │     │     │     │     │
       │ Feature        │     │     │     │     │     │     │     │     │     │     │     │     │
       │ Name           │     │     │     │     │     │     │     │     │     │     │     │     │
       ├────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │ glQueryCounter │  -  │  -  │  -  │  -  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
       └────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘