glGetBufferPointerv — return the pointer to a mapped buffer object's data store
void glGetBufferPointerv(
|
GLenum target, |
| GLenum pname, | |
void ** params); |
target
Specifies the target to which the buffer object is bound
for glGetBufferPointerv, which must
be one of the buffer binding targets in the following
table:
| Buffer Binding Target | Purpose |
|---|---|
GL_ARRAY_BUFFER
|
Vertex attributes |
GL_ATOMIC_COUNTER_BUFFER
|
Atomic counter storage |
GL_COPY_READ_BUFFER
|
Buffer copy source |
GL_COPY_WRITE_BUFFER
|
Buffer copy destination |
GL_DISPATCH_INDIRECT_BUFFER
|
Indirect compute dispatch commands |
GL_DRAW_INDIRECT_BUFFER
|
Indirect command arguments |
GL_ELEMENT_ARRAY_BUFFER
|
Vertex array indices |
GL_PIXEL_PACK_BUFFER
|
Pixel read target |
GL_PIXEL_UNPACK_BUFFER
|
Texture data source |
GL_SHADER_STORAGE_BUFFER
|
Read-write storage for shaders |
GL_TEXTURE_BUFFER
|
Texture data buffer |
GL_TRANSFORM_FEEDBACK_BUFFER
|
Transform feedback buffer |
GL_UNIFORM_BUFFER
|
Uniform block storage |
pname
Specifies the pointer to be returned. The symbolic constant must be GL_BUFFER_MAP_POINTER.
params
Returns the pointer value specified by pname.
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.
If an error is generated,
no change is made to the contents of params.
The initial value for the pointer is NULL.
The GL_COPY_READ_BUFFER, GL_COPY_WRITE_BUFFER,
GL_PIXEL_PACK_BUFFER,GL_PIXEL_UNPACK_READ_BUFFER,
GL_TRANSFORM_FEEDBACK_BUFFER and GL_UNIFORM_BUFFER
targets are available only if the GL ES version is 3.0 or greater.
The GL_ATOMIC_COUNTER_BUFFER, GL_DISPATCH_INDIRECT_BUFFER,
GL_DRAW_INDIRECT_BUFFER and GL_SHADER_STORAGE_BUFFER
targets are available only if the GL ES version is 3.1 or greater.
The GL_TEXTURE_BUFFER target is available only if the GL ES version is 3.2 or greater.
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.
| OpenGL ES API Version | ||||
|---|---|---|---|---|
| Function Name | 2.0 | 3.0 | 3.1 | 3.2 |
| glGetBufferPointerv | - | ✔ | ✔ | ✔ |
Copyright © 2005 Addison-Wesley. Copyright © 2010-2015 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/.