prg_mt_mutex_create()

摘要

创建一个 mutex 对象,用于在并行环境中对共享资源的访问进行串行化。

语法

prg_mt_mutex_create (options, rank, description, result_ptr)
参数 类型 说明
options int 取以下值之一:
• PRGC_MT_MUTEX_NO_OPTIONS:基本 mutex
• PRGC_MT_MUTEX_RECURSIVE:递归 mutex
• PRGC_MT_MUTEX_READER_WRITER:读/写 mutex,可与 PRGC_MT_MUTEX_RANK_CHECK 按位或(C 语言的 |)组合:利用等级信息在加锁顺序不当时阻止加锁;与 PRGC_MT_MUTEX_LOCK_ID_TRACK 按位或组合:记录进程 ID 用于错误报告
rank int mutex 的等级;除非 options 中包含 PRGC_MT_MUTEX_RANK_CHECK,否则被忽略
description const char * 人类可读的描述,用于 prg_mt 包生成的错误消息
result_ptr PrtT_Mutex_Result 用于存放结果值的可选存储空间(若设置为 PRGC_NIL,则不提供该值)

返回类型

PrgT_Mutex *

生成的 mutex 对象;若创建失败则返回 PRGC_NIL。

头文件

prg_mt.h

详情

此函数允许你创建包概述中所述的某一种 mutex 形式。生成的对象应与 prg_mt_mutex_lock() 和 prg_mt_mutex_unlock() 配合使用,以正确访问共享资源。

如果可能,每个共享资源都应有自己的 mutex。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com