PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions > PviChgLinkRequest, PviXChgLinkRequest functions

Definition for C/C++

int PviChgLinkRequest (DWORD LinkID, DWORD EventMsgNo, LPARAM EventParam, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

int PviXChgLinkRequest (DWORD hPvi, DWORD LinkID, DWORD EventMsgNo, LPARAM EventParam, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

Definition for Basic

PviChgLinkRequest (ByVal LinkID As Long, ByVal EventMsgNo As Long, ByVal EventParam As Long, ByVal hResMsg As Long, ByVal ResMsgNo As Long, ByVal ResParam As Long) As Long

PviXChgLinkRequest (ByVal hPvi As Long, ByVal LinkID As Long, ByVal EventMsgNo As Long, ByVal EventParam As Long, ByVal hResMsg As Long, ByVal ResMsgNo As Long, ByVal ResParam As Long) As Long

Arguments

Argument	I/O	说明
hPvi	In	来自 PviXInitialize 函数的实例句柄
LinkID	In	来自 PviCreateResponse, PviLinkResponse 或PviXCreateResponse, PviXLinkResponse函数的链接ID
EventMsgNo	In	用户信息的新信息编号。 = 0 (Null)。没有给链接对象分配事件数据的用户消息
EventParam	In	用户消息的新消息参数 32位PVI版本（PviCom.dll）的消息参数（用户参数）大小为4字节，64位PVI版本（PviCom64.dll）为8字节。
hResMsg	In	为该函数调用发出响应信号的用户信息的定义（请求和响应）。 = 0 (Null)。PVI管理器不发送任何响应
ResMsgNo	In	用户信息的信息编号 = 0 (Null):与hResMsg=0含义相同。
ResParam	In	用户信息的消息参数在32位PVI版本（PviCom.dll）中，消息参数（用户参数）的大小为4字节，在64位PVI版本（PviCom64.dll）中为8字节。

Return value

如果数值不是0，则表明有错误。错误代码被作为一个值返回。原则上，这个函数只报告Windows资源错误（如没有足够的可用内存）或用户错误（如非法的函数参数，不正确的函数使用，等等）。在这种情况下，不会向PVI管理器发送请求，也不会执行定义的响应信息。如果在数据传输过程中或在处理请求时发生错误，那么它将只与响应数据一起报告。

Description

该函数发送一个请求，以改变事件数据的用户信息。响应数据必须用 PviChgLinkResponse 或PviXChgLinkResponse函数读取，除非使用 PVICALLBACK_DATA 类型的回调函数。

如果使用窗口信息作为用户信息，那么可以用PviChgLinkRequest改变信息编号（EventMsgNo）和信息参数（EventParam）。如果使用回调函数作为用户消息，只有消息参数（EventParam）可以改变。在这种情况下，指定消息编号是不相关的。

POBJ_ACC_EVMASK 访问类型是为了启用或禁用事件。PviChgLinkRequest不应该被用于此目的。