CAPL学习-SOME/IP交互层-静态配置类函数

车载测试工程师2025-12-16 9:11

Static Configuration

SomeIpProvidedEventAddConsumer

函数

向提供的事件添加消费者。之后，事件通知将发送到此消费者。

语法

capl 复制代码 
long SomeIpProvidedEventAddConsumer(dword pevHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedEventAddConsumer(dword pevHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedEventAddConsumer(dword pevHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • pevHandle：提供的事件句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpProvidedEventGroupAddConsumer

函数

向提供的事件组添加消费者。之后，事件/字段通知将发送到此消费者。

语法

capl 复制代码 
long SomeIpProvidedEventGroupAddConsumer(dword pevgHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedEventGroupAddConsumer(dword pevgHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedEventGroupAddConsumer(dword pevgHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • pevgHandle：提供的事件组句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpProvidedEventGroupRemoveConsumer

函数

从提供的事件组中移除消费者。之后，事件/字段通知将不再发送到此消费者。

语法

capl 复制代码 
long SomeIpProvidedEventGroupRemoveConsumer(dword pevgHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedEventGroupRemoveConsumer(dword pevgHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedEventGroupRemoveConsumer(dword pevgHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • pevgHandle：提供的事件组句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpProvidedEventRemoveConsumer

函数

从提供的事件中移除通过 SomeIpProvidedEventAddConsumer 添加的消费者。

语法

capl 复制代码 
long SomeIpProvidedEventRemoveConsumer(dword pevHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedEventRemoveConsumer(dword pevHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedEventRemoveConsumer(dword pevHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • pevHandle：提供的事件句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpProvidedEventsAndFieldsAddConsumer

函数

向提供的服务实例添加消费者。之后，该服务实例的所有事件/字段通知将发送到此消费者。

语法

capl 复制代码 
long SomeIpProvidedEventsAndFieldsAddConsumer(dword psiHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedEventsAndFieldsAddConsumer(dword psiHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedEventsAndFieldsAddConsumer(dword psiHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • psiHandle：提供的服务实例句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpProvidedEventsAndFieldsRemoveConsumer

函数

从提供的服务实例中移除通过 SomeIpProvidedEventsAndFieldsAddConsumer 添加的消费者。

语法

capl 复制代码 
long SomeIpProvidedEventsAndFieldsRemoveConsumer(dword psiHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedEventsAndFieldsRemoveConsumer(dword psiHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedEventsAndFieldsRemoveConsumer(dword psiHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • psiHandle：提供的服务实例句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpProvidedFieldAddConsumer

函数

向提供的字段添加消费者。之后，字段通知将发送到此消费者。

语法

capl 复制代码 
long SomeIpProvidedFieldAddConsumer(dword pfHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedFieldAddConsumer(dword pfHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedFieldAddConsumer(dword pfHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • pfHandle：提供的字段句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpProvidedFieldRemoveConsumer

函数

从提供的字段中移除通过 SomeIpProvidedFieldAddConsumer 添加的消费者。

语法

capl 复制代码 
long SomeIpProvidedFieldRemoveConsumer(dword pfHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpProvidedFieldRemoveConsumer(dword pfHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpProvidedFieldRemoveConsumer(dword pfHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • pfHandle：提供的字段句柄（可通过 SomeIpGetProvidedObjectHandle 获取）。
  • remoteIPv4Address：消费者的IPv4地址（网络字节序）。
  • remoteIPv6Address：消费者的IPv6地址。
  • remoteUDPPort：消费者的UDP端口号（无则为0）。
  • remoteTCPPort：消费者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含消费者地址/端口的 IP_Endpoint 类型对象。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpSetMulticastReceiverEndpoints

函数

为消费的事件组设置多播端点，用于通过多播接收字段/事件通知。

语法

capl 复制代码 
long SomeIpSetMulticastReceiverEndpoints(dword cevgHandle, dword multicastIPv4Address, dword udpPort); // 形式1  
long SomeIpSetMulticastReceiverEndpoints(dword cevgHandle, byte multicastIPv6Address[], dword udpPort); // 形式2  
long SomeIpSetMulticastReceiverEndpoints(dword cevgHandle, IP_Endpoint multicastIPEndpoint); // 形式3

参数

  • cevgHandle：消费的事件组句柄（可通过 SomeIpGetConsumedObjectHandle 获取）。
  • multicastIPv4Address：接收事件/字段的多播IPv4地址（网络字节序）。
  • multicastIPv6Address：接收事件/字段的多播IPv6地址。
  • udpPort：接收事件/字段的UDP端口号（不再通过多播接收则为0）。
  • multicastIPEndpoint：包含多播端点地址/端口的 IP_Endpoint 类型对象（端口为0时删除现有端点）。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。

SomeIpSetProviderEndpoints

函数

为消费的服务实例设置UDP和TCP端点，用于访问对应的提供的服务实例。

语法

capl 复制代码 
long SomeIpSetProviderEndpoints(dword csiHandle, dword remoteIPv4Address, dword remoteUDPPort, dword remoteTCPPort); // 形式1  
long SomeIpSetProviderEndpoints(dword csiHandle, byte remoteIPv6Address[], dword remoteUDPPort, dword remoteTCPPort); // 形式2  
long SomeIpSetProviderEndpoints(dword csiHandle, IP_Endpoint remoteIPEndpoint); // 形式3

参数

  • csiHandle：消费的服务实例句柄（可通过 SomeIpGetConsumedObjectHandle 获取）。
  • remoteIPv4Address：提供者的IPv4地址（网络字节序）。
  • remoteIPv6Address：提供者的IPv6地址。
  • remoteUDPPort：提供者的UDP端口号（无则为0）。
  • remoteTCPPort：提供者的TCP端口号（无则为0）。
  • remoteIPEndpoint：包含提供者地址/端口的 IP_Endpoint 类型对象（端口为0时删除现有端点）。

返回值

  • 0：函数执行成功。

  • 0：错误代码。

可用性

  • 形式1-2：CANoe 11.0 SP3及以上，仅适用于以太网仿真/测试环境。
  • 形式3：CANoe 12.0 SP2及以上，仅适用于以太网仿真/测试环境。
相关推荐
玩转4G物联网11 小时前
FS800DTU 新品上线｜免费使用 DMP 设备管理平台，支持远程批量配置 & OTA 升级
物联网·网络协议·tcp/ip·云平台·核心板·fs800dtu·iot管理平台
wuqingshun31415912 小时前
说说TCP的3次握手？为什么需要三次握手？
服务器·网络协议·tcp/ip
无锡耐特森13 小时前
解决网关数据异常EtherNetIP 转Modbus TCP专用动态监测
网络·网络协议·tcp/ip
2401_8734794014 小时前
爬虫IP怎么防？IP离线库四层识别+日志留存，反爬留证两不误
爬虫·网络协议·tcp/ip·ip
房开民14 小时前
Qt TCP 服务器开发实战：与 VisionMaster OCR 通信
服务器·qt·tcp/ip
超级赛博搬砖工15 小时前
什么是移动代理IP？与住宅IP有何区别？
网络·网络协议·tcp/ip
Tizzgod16 小时前
W55MH32 开箱分享 — 一块板子同时连俩TCP服务器
服务器·网络协议·tcp/ip
lzhdim1 天前
1分钟查清局域网所有IP
运维·服务器·网络·网络协议·tcp/ip
我是唐青枫1 天前
Java Netty 实战指南：从 NIO 线程模型到 TCP 编解码和心跳机制
java·tcp/ip·nio
ttod_qzstudio1 天前
【软考备考】计算机网络详解：OSI/TCP-IP 分层 + IP 子网划分，一篇拿下网络模块（附 10 道练习）
网络·tcp/ip·计算机网络·软考
热门推荐
01GitHub 镜像站点022026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片03如何新建文件夹？ 电脑新建文件夹的4种方法04幻兽帕鲁 - 服务器管理员权限与 GM 命令完全指南05AI科技热点日报 | 2026年07月01日06国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）07AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路08【AI前线观察】2026年国产开源大模型全面横评：从 DeepSeek V4 到 Kimi K3，谁才是开发者的最优选择？092026 年 AI 大模型 & AI 编程工具实战全总结102026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？