nrac_consumer_remove_from_resource()
摘要
删除消费者与资源之间的关联。
语法
nrac_consumer_remove_from_resource (resource_handle, consumer_handle, event_handle)
| 参数 | 类型 | 说明 |
|---|---|---|
resource_handle |
Nrac_Resource_Handle |
消费者当前正在使用的资源的句柄 |
consumer_handle |
Nrac_Consumer_Handle |
将被移除的消费者的句柄。使用 NRAC_ANY_CONSUMER 可移除所有消费者。 |
event_handle |
Nrac_Event_Handle |
条件化事件的句柄;使用 NRAC_ANY_EVENT 表示事件无关紧要。 |
返回类型
int
实际从资源中移除的消费者数量。由于条件事件的存在,同一资源可能会从某个给定资源中被移除多次。
头文件
nrac.h
详情
在最简单的形式下,此函数可以撤销对 nrac_resource_consumer_add() 调用的效果,一次移除一个消费者。如果传入了特定的消费者和特定的事件,并且在资源上找到了符合期望事件条件的匹配消费者,则该消费者会被移除。消费者句柄和事件句柄中的任一个或两者都可以分别用 NRAC_ANY_CONSUMER 和 NRAC_ANY_EVENT 作为通配。“任意”消费者表示在指定事件条件下移除所有消费者。“任意”事件表示匹配时不考虑事件——所有匹配的消费者都会被移除,而不论它们可能取决于哪个事件。