GLAPI/glGetBufferPointer: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
4.0 API.
 
m moved GLAPI/glGetBufferPointerv to GLAPI/glGetBufferPointer: Normalizing names of API functions, so that they don't have suffixes.
(No difference)

Revision as of 02:57, 30 January 2012

glGetBufferPointerv
Core in version 4.6
Core since version 1.5

glGetBufferPointerv: return the pointer to a mapped buffer object's data store

Function Definition

 void glGetBufferPointerv(GLenum target, GLenum pname, GLvoid ** params);
target
Specifies the target buffer object. The symbolic constant must be GL_ARRAY_BUFFER, GL_COPY_READ_BUFFER, GL_COPY_WRITE_BUFFER, GL_ELEMENT_ARRAY_BUFFER, GL_PIXEL_PACK_BUFFER, GL_PIXEL_UNPACK_BUFFER, GL_TEXTURE_BUFFER, GL_TRANSFORM_FEEDBACK_BUFFER, or GL_UNIFORM_BUFFER.
pname
Specifies the pointer to be returned. The symbolic constant must be GL_BUFFER_MAP_POINTER.
params
Returns the pointer value specified by pname.

Description

glGetBufferPointerv returns pointer information. pname is a symbolic constant indicating the pointer to be returned, which must be GL_BUFFER_MAP_POINTER, the pointer to which the buffer object's data store is mapped. If the data store is not currently mapped, NULL is returned. params is a pointer to a location in which to place the returned pointer value.

Notes

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

The initial value for the pointer is NULL.

Errors

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

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

See Also

glBindBuffer, glMapBuffer

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