op_pk_fd_set_info()
摘要
为指定数据包中的 information 字段指定类型和大小;目标字段由数字索引指定。
语法
op_pk_fd_set_info (pkptr, field_index, value, field_size)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
field_index |
int |
目标字段的数字索引 [该值必须为非负数,否则会发生错误。] |
field_size |
OpT_Int64 |
字段内容的大小(以比特计),或 OPC_FIELD_SIZE_UNCHANGED(见详情) |
返回类型
Compcode
如果字段能够被设置,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
/* create an unformatted packet */
uf_pkptr = op_pk_create (0);
/* assign an integer code to the packet */
op_pk_fd_set (uf_pkptr, FD_TYPE, OPC_FIELD_TYPE_INTEGER, DATA_XFER, 16);
/* assign an information field to the packet */
op_pk_fd_set_info (uf_pkptr, FD_DATA, 1500);
/* send the defined packet out of the processor */
op_pk_send (uf_pkptr, OUTSTRM);
详情
对于 information 字段,只需指定字段的大小,因为该字段所建模数据的实际值与仿真无关。通过内核过程 op_pk_fd_get() 获取 information 字段的值并没有有效用途,但它不会导致错误,而是将字符串“unspecified”复制到传入的值指针中。
如果 field_size 与字段的先前大小不同,数据包的总大小将相应变化。如果 field_size 指定为 OPC_FIELD_SIZE_UNCHANGED,字段的大小将保持数据包中原有的定义。
用途
提供一种设置数据包中 information 字段值的方法。该内核过程通常用于非格式化数据包,但也可以用于有格式数据包(有格式数据包的字段名称可以使用内核过程 op_pk_name_to_index() 和 op_pk_nfd_name_to_index() 转换为数字索引)。
错误
- 与 op_pk_fd_set()(information 字段版本)相同。
参考
- 与 op_pk_fd_set()(information 字段版本)相同。