From OpenGL Wiki
Jump to: navigation, search
Core in version 4.6
Core since version 4.3
Core ARB extension KHR_debug

glGetObjectPtrLabel: retrieve the label of a sync object identified by a pointer

Function Definition

 void glGetObjectPtrLabel(void * ptr​, GLsizei bifSize​, GLsizei * length​, char * label​);
The name of the sync object whose label to retrieve.
The length of the buffer whose address is in label​.
The address of a variable to receive the length of the object label.
The address of a string that will receive the object label.


glGetObjectPtrLabel retrieves the label of the sync object identified by ptr​.

label​ is the address of a string that will be used to store the object label. bufSize​ specifies the number of characters in the array identified by label​. length​ contains the address of a variable which will receive the the number of characters in the object label. If length​ is NULL, then it is ignored and no data is written. Likewise, if label​ is NULL, or if bufSize​ is zero then no data is written to label​.


GL_INVALID_ENUM is generated if identifier​ is not one of the accepted object types.

GL_INVALID_VALUE is generated if ptr​ is not the name of an existing sync object.

GL_INVALID_VALUE is generated if bufSize​ is zero.

If not NULL, length​ and label​ should be addresses to which the client has write access, otherwise undefined behavior, including process termination may occur.

Associated Gets

glGet with argument GL_MAX_LABEL_LENGTH.

See Also

glGetObjectLabel, glObjectPtrLabel


Copyright © 2012 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.