nrac_resource_consumers_get()
摘要
获取使用某个特定资源的消费者列表。
语法
nrac_resource_consumers_get (resource_handle, event_handle)
| 参数 | 类型 | 说明 |
|---|---|---|
resource_handle |
Nrac_Resource_Handle |
目标资源的句柄 |
event_handle |
Nrac_Event_Handle |
用于限定适用消费者的事件句柄。使用 NRAC_ANY_EVENT 可返回所有消费者。 |
返回类型
PrgT_List *
元素类型为 Nrac_Conditional_Consumer_Handle 的列表。提供对消费者及其所依赖事件的访问。
头文件
nrac.h
详情
此函数构建给定资源上所有消费者的列表。结果可以仅基于相对于某个特定事件的消费者;如果传入 NRAC_ANY_EVENT,则考虑所有消费者,而不论它们依赖于哪个事件。列表由类型为 Nrac_Conditional_Consumer_Handle 的元素组成,可同时访问消费者及其所依赖的事件。
调用此函数获得的句柄列表不由 NRAC 包维护。一旦返回给调用代码,在提取完所有所需信息之后,释放该内存就是程序员的责任。最简便的做法是调用 prg_list_free() 释放列表中的元素,并用 prg_mem_free() 释放列表容器对象本身。另外,也可以使用 nrac_conditional_consumer_destroy() 逐个释放列表中的元素。