Light | Dark

# docs.GL

OpenGL 4
OpenGL 3
OpenGL 2
OpenGL ES 3

# glGenQueries

## Name

glGenQueries — generate query object names

## C Specification

`void glGenQueries(` | GLsizei n,
| GLuint * ids`)`;

## Parameters

`n`

  Specifies the number of query object names to be generated.

`ids`

  Specifies an array in which the generated query object names are stored.

## Description

`glGenQueries` returns `n` query object names in `ids`. There is no guarantee that the names form a contiguous set of integers; however, it is guaranteed that none of the returned names was in use immediately before the call to `glGenQueries`.

Query object names returned by a call to `glGenQueries` are not returned by subsequent calls, unless they are first deleted with glDeleteQueries.

The names returned in `ids` are marked as used, for the purposes of `glGenQueries` only, but no query objects are associated with the returned query object names until they are first used by calling glBeginQuery.

## Errors

`GL_INVALID_VALUE` is generated if `n` is negative.

## Associated Gets

glIsQuery

## Tutorials

open.gl - Transform Feedback

## API Version Support

| OpenGL ES API Version
--- | ---
Function Name | 2.0 | 3.0 | 3.1
glGenQueries | - | ✔ | ✔

## See Also

glBeginQuery, glDeleteQueries, glEndQuery, glGet

## Copyright

Copyright © 2005 Addison-Wesley. Copyright © 2010-2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. https://opencontent.org/openpub/.

Think you can improve this page? Edit this page on GitHub.