2005
Sams Publishing
glGenQueries
3G

# 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.

No query objects are associated with the returned query object names until they are first used by calling glBeginQuery.

## Notes

`glGenQueries` is available only if the GL version is 1.5 or greater.

## Errors

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

`GL_INVALID_OPERATION` is generated if `glGenQueries` is executed between the execution of glBeginQuery and the corresponding execution of glEndQuery.

`GL_INVALID_OPERATION` is generated if `glGenQueries` is executed between the execution of glBegin and the corresponding execution of glEnd.

## Associated Gets

glIsQuery

## See Also

glBeginQuery, glDeleteQueries, glEndQuery

## Copyright

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