op_pk_encap_pk_access()

摘要

从指定的封装数据包中获取被封装数据包的引用。

语法

op_pk_encap_pk_access (pkptr, format, encap_pk_pptr)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
format const char* 指向字符串的指针,该字符串包含某个数据包格式的名称,或「详情」一节所述的某个符号常量
encap_pk_pptr Packet** 数据包指针的指针
[此处指定的指针将被填入指向被封装数据包的指针。]

返回类型

Compcode

如果找到被封装的数据包,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

示例

if (op_pk_encap_flag_is_set (pkptr, OMSC_BGUTIL_ENCAP_FLAG_INDEX))
	{
	/* Drill to get the actual bgutil packet. */
	op_pk_encap_pk_access (pkptr, "bgutil_tracer", &bgutil_pkptr);

	if (bgutil_pkptr == OPC_NIL)
		{
		return_routed_bgutil = 0.0;
		*routed_packets_per_sec_ptr = 0.0;
		FRET (return_routed_bgutil);
		}

	/* Get the src and dest objids. */
	op_pk_nfd_get (bgutil_pkptr, "src_objid", &src_objid);
	op_pk_nfd_get (bgutil_pkptr, "dest_objid", &dest_objid);

	...

	}

详情

该函数在指定数据包中搜索其中封装的、具有给定格式的其他数据包。它返回具有指定格式的第一个被封装数据包的引用(包括 SAR 分段)。如果返回了某个数据包,则该数据包及其所有封装数据包都不再是共享的。

除格式名称外,format 还可以是下表所述的某个常量。

如果常量为… 该函数获取的第一个…
NONE 无格式或值向量数据包
OPC_PK_FORMAT_ANY 数据包(不论格式)
OPC_PK_FORMAT_ANY_FORMATTED 有格式的数据包
OPC_PK_FORMAT_ANY_UNFORMATTED 无格式的数据包
OPC_PK_FORMAT_ANY_VVEC 值向量数据包

如果封装数据包内部没有指定格式的数据包,该函数返回 OPC_FAILURE。

用途

提供一种快速获取被封装数据包引用的机制。

错误

  • 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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