nrac_resource_consumer_add()
摘要
将消费者与资源关联,使消费者成为该资源的使用者。
语法
nrac_resource_consumer_add (resource_handle, consumer_handle, event_handle)
| 参数 | 类型 | 说明 |
|---|---|---|
resource_handle |
Nrac_Resource_Handle |
将被消费者使用的资源的句柄 |
consumer_handle |
Nrac_Consumer_Handle |
将使用该资源的消费者的句柄 |
event_handle |
Nrac_Event_Handle |
条件化事件的句柄。使用 NRAC_ANY_EVENT 表示无条件使用该资源。 |
返回类型
Compcode
只有当此新绑定与先前已创建的绑定重复,或者内存资源不足时,才会发生失败
头文件
nrac.h
详情
每个消费者可以使用多个资源,每个资源反过来也可以被多个消费者使用。对这些关联的任何限制约束(例如防止资源过载)完全由应用程序决定,而非由 NRAC 包决定。因此,除非试图建立重复的关联,此调用都会成功。
消费者与资源之间的绑定可以取决于某个特定事件。该事件必须已在之前某个时刻通过 nrac_event_create() 创建。事件用于区分在不同情形下使用同一资源的不同消费者。因此,一个资源可以支撑许多消费者,却仍然不会“过载”,因为这些消费者未必会同时使用该资源。若要表示消费者无论如何都使用该资源,请在事件参数中传入特殊事件句柄 NRAC_ANY_EVENT。单个资源可以同时支撑条件消费者与无条件消费者的混合。