NAME

       glGetBufferParameteriv - return parameters of a buffer object

C SPECIFICATION

       void glGetBufferParameteriv(GLenum target, GLenum value, GLint * data);

       void glGetBufferParameteri64v(GLenum target, GLenum value, GLint64 * data);

PARAMETERS

       target
           Specifies the target buffer object. The symbolic constant must be GL_ARRAY_BUFFER,
           GL_ATOMIC_COUNTER_BUFFER, GL_COPY_READ_BUFFER, GL_COPY_WRITE_BUFFER,
           GL_DRAW_INDIRECT_BUFFER, GL_DISPATCH_INDIRECT_BUFFER, GL_ELEMENT_ARRAY_BUFFER,
           GL_PIXEL_PACK_BUFFER, GL_PIXEL_UNPACK_BUFFER, GL_QUERY_BUFFER,
           GL_SHADER_STORAGE_BUFFER, GL_TEXTURE_BUFFER, GL_TRANSFORM_FEEDBACK_BUFFER, or
           GL_UNIFORM_BUFFER.

       value
           Specifies the symbolic name of a buffer object parameter. Accepted values are
           GL_BUFFER_ACCESS, GL_BUFFER_MAPPED, GL_BUFFER_SIZE, or GL_BUFFER_USAGE.

       data
           Returns the requested parameter.

DESCRIPTION

       glGetBufferParameteriv returns in data a selected parameter of the buffer object specified
       by target.

       value names a specific buffer object parameter, as follows:

       GL_BUFFER_ACCESS
           params returns the access policy set while mapping the buffer object. The initial
           value is GL_READ_WRITE.

       GL_BUFFER_MAPPED
           params returns a flag indicating whether the buffer object is currently mapped. The
           initial value is GL_FALSE.

       GL_BUFFER_SIZE
           params returns the size of the buffer object, measured in bytes. The initial value is
           0.

       GL_BUFFER_USAGE
           params returns the buffer object's usage pattern. The initial value is GL_STATIC_DRAW.

NOTES

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

       The GL_ATOMIC_COUNTER_BUFER target is available only if the GL version is 4.2 or greater.

       The GL_DISPATCH_INDIRECT_BUFFER and GL_SHADER_STORAGE_BUFFER targets are available only if
       the GL version is 4.3 or greater.

       The GL_QUERY_BUFFER target is available only if the GL version is 4.4 or greater.

ERRORS

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

       GL_INVALID_OPERATION is generated if the reserved buffer object name 0 is bound to target.

SEE ALSO

       glBindBuffer(), glBufferData(), glMapBuffer(), glUnmapBuffer()

COPYRIGHT

       Copyright © 2005 Addison-Wesley. Copyright © 2010-2013 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.  http://opencontent.org/openpub/.

AUTHORS

       opengl.org