op_pk_creation_mod_set()

Abstract

Changes the object ID that specifies the creation module of a packet.

Syntax

op_pk_creation_mod_set (pkptr, objid)
Argument Type Description
pkptr Packet* pointer to the packet-of-interest
[A pointer to a packet can be obtained from many KPs, including op_pk_create(), op_pk_create_fmt(), op_pk_copy(), op_pk_get(), op_subq_pk_access(), and op_subq_pk_remove().]
objid Objid new creation module ID, or OPC_OBJID_UNIVERSAL

Return Type

Compcode

Completion code indicating if the change was successful.

If successful, this KP returns the value OPC_COMPCODE_SUCCESS; OPC_COMPCODE_FAILURE otherwise.

Example

/* declarations */
Packet *uf_pkptr;

/* create an unformatted packet */
uf_pkptr = op_pk_create (64);

/* set the object ID of packet’s creation module */
op_pk_creation_mod_set (uf_pkptr, op_id_self());

Details

A process model invoking this function must own the packet to be changed; non-process model code can use this function for any packet.

Purpose

Provides a way for cosimulations to reset the creation module for packets converted from value vector representation.

Errors

  • Program Abort: Segmentation violation. (due to an invalid packet pointer or malformed packet)
  • Program Abort: Packet pointer is NIL.
  • Program Abort: Packet pointer references destroyed packet.
  • Program Abort: Packet pointer references unowned packet (<pk_id>).
  • Program Abort: Only modules can be set as packet creator. Objid (<objid>) is <type>.

Reference

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