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及以上，仅适用于以太网仿真/测试环境。
相关推荐
gihigo19982 天前
基于TCP协议实现视频采集与通信
网络协议·tcp/ip·音视频
龙仔7253 天前
在麒麟V10服务器安全加固，sshd防暴力破解加固，实现“密码错误3次封IP”的需求
服务器·tcp/ip·安全
凯酱3 天前
Windows防火墙入站规则IP白名单
windows·网络协议·tcp/ip
上海云盾王帅3 天前
从底层守护：深度解析四层协议（TCP/UDP）的DDoS防护之道
tcp/ip·udp·ddos
IP搭子来一个3 天前
独享IP和共享IP怎么选？全面对比解析
运维·网络·tcp/ip
科技块儿3 天前
如何用离线库秒筛“数据中心”IP段并自动封号？
网络·网络协议·tcp/ip
上海云盾第一敬业销售3 天前
选择最佳高防CDN与高防IP服务以保证网站安全
网络协议·tcp/ip·安全
傻啦嘿哟3 天前
免费代理IP获取与验证：实战爬取代理网站并筛选可用IP
网络·网络协议·tcp/ip
上海云盾-小余3 天前
高防IP与传统防护的互补性分析
网络·网络协议·tcp/ip
科技块儿3 天前
开发者需要为网站或应用集成IP归属地显示功能，如何选择可靠的数据源？
服务器·网络·数据库·tcp/ip·edge·ip
热门推荐
01GitHub 镜像站点02【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆03OpenClaw 使用和管理 MCP 完全指南04Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤05OpenClaw + 飞书（Feishu）环境搭建指南06Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services07Window 10部署openclaw报错node.exe : npm error code 12808AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南09AI Agent 平台横评：ZeroClaw vs OpenClaw vs Nanobot10OpenClaw优化飞书API 额度已耗尽问题