PviLink, PviXLink functions

<< 点击显示目录 >>

主页  PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions >

PviLink, PviXLink functions

Definition for C/C++

int PviLink (LPDWORD pLinkID, LPCSTR pObjectName, LPVOID hEventMsg, DWORD EventMsgNo, LPARAM EventParam, LPCSTR pLinkDescriptor)

int PviXLink (DWORD hPvi, LPDWORD pLinkID, LPCSTR pObjectName, LPVOID hEventMsg, DWORD EventMsgNo, LPARAM EventParam, LPCSTR pLinkDescriptor)

Definition for Basic

PviLink (ByRef pLinkID As Long, ByVal pObjectName As String, ByVal hEventMsg As Long, ByVal EventMsgNo As Long, ByVal EventParam As Long, ByVal pLinkDescriptor As String) As Long

PviXLink (ByVal hPvi As Long, ByRef pLinkID As Long, ByVal pObjectName As String, ByVal hEventMsg As Long, ByVal EventMsgNo As Long, ByVal EventParam As Long, ByVal pLinkDescriptor As String) As Long

Arguments

Argument

I/O

说明

hPvi

In

来自 PviXInitialize 函数的实例句柄

pLinkID

Out

指向用于记录链接ID的变量的指针

pObjectName

In

指向 对象名称对象路径名称的指针。以空结尾的字符串形式给出。

hEventMsg

In

用户信息的定义 ,它被分配给链接对象,用于信号事件数据(事件)。不能为该参数指定0(零)。

EventMsgNo

In

用户信息的信息编号

= 0(空)。在这种情况下,可以为hEventMsg指定除0以外的任何值(例如PVI_HMSG_NIL)。

EventParam

In

用户信息的消息参数 在32位PVI版本(PviCom.dll)中,消息参数(用户参数)的大小为4字节,在64位PVI版本(PviCom64.dll)中为8字节。

pLinkDescriptor

In

指向 链接对象描述的指针。以空结尾的字符串形式给出。

Return value

如果数值不是0,则表明有错误。错误代码将作为一个值返回。如果在执行请求时发生错误,或者 通信实例 和PVI管理器之间的连接  被中断(通信超时)则报告错误

Description

该函数是 PviLinkRequest / PviLinkResponse 或PviXLinkRequest/PviXLinkResponse功能 的同步变体 参见 异步和同步函数 部分。