GLES3.0中文API-glGetSynciv

名称

glGetSynciv — 查询同步对象的属性

C规格

void glGetSynciv( GLsync sync,
GLenum pname,
GLsizei bufSize,
GLsizei *length,
GLint *values);

参数

sync
指定要查询其属性的同步对象。

pname
指定要从同步中指定的同步对象中检索其值的参数。

bufSize
指定缓冲区的大小，其地址以值给出。

length
指定变量的地址，以接收放置在值中的整数数量。

values
Specifies the address of an array to receive the values of the queried parameter.

指定一个数组的地址以接收查询的参数的值。

描述

glGetSynciv检索同步对象的属性。 sync指定要检索其属性的同步对象的名称。

成功后，glGetSynciv会用要查询的对象的相应属性值替换值中的bufSize整数。实际替换的整数数将在其地址指定为长度的变量中返回。如果length为NULL，则不返回任何长度。

如果pname为GL_OBJECT_TYPE，则将代表同步对象特定类型的单个值放置在值中。支持的唯一类型是GL_SYNC_FENCE。

如果pname为GL_SYNC_STATUS，则将代表同步对象状态的单个值（GL_SIGNALED或GL_UNSIGNALED）放置在值中。

如果pname为GL_SYNC_CONDITION，则将代表同步对象条件的单个值放置在值中。支持的唯一条件是GL_SYNC_GPU_COMMANDS_COMPLETE。

如果pname为GL_SYNC_FLAGS，则将代表创建同步对象的标志的单个值放置在值中。当前不支持任何标志[1]。

如果发生错误，则不会将任何内容写入值或长度。

错误

如果sync不是同步对象的名称，则生成GL_INVALID_VALUE。

如果pname不是可接受的令牌之一，则生成GL_INVALID_ENUM。

API版本支持

函数名	2.0	3.0	3.1	3.2
glGetSynciv	-	✔	✔	✔

另见

glFenceSync, glWaitSync, glClientWaitSync

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3/html/glGetSynciv.xhtml
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. http://opencontent.org/openpub/.

[1] 标志将在以后对同步对象的扩展中使用。