glGetQueryiv — return parameters of a query object target

C Specification

void glGetQueryiv(GLenum target,
 GLenum pname,
 GLint * params);



Specifies a query object target. Must be GL_SAMPLES_PASSED.


Specifies the symbolic name of a query object target parameter. Accepted values are GL_CURRENT_QUERY or GL_QUERY_COUNTER_BITS.


Returns the requested data.


glGetQueryiv returns in params a selected parameter of the query object target specified by target.

pname names a specific query object target parameter. When target is GL_SAMPLES_PASSED, pname can be as follows:


params returns the name of the currently active occlusion query object. If no occlusion query is active, 0 is returned. The initial value is 0.


params returns the number of bits in the query counter used to accumulate passing samples. If the number of bits returned is 0, the implementation does not support a query counter, and the results obtained from glGetQueryObject are useless.


If an error is generated, no change is made to the contents of params.

glGetQueryiv is available only if the GL version is 1.5 or greater.


GL_INVALID_ENUM is generated if target or pname is not an accepted value.

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

See Also

glGetQueryObject, glIsQuery


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.