<< 点击显示目录 >> 主页  PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions > PviInitialize, PviXInitialize functions

Definition for C/C++

int PviInitialize (INT Timeout, INT RetryTime, LPCSTR pInitParam, LPVOID pRes)

int PviXInitialize (LPDWORD phPvi, INT Timeout, INT RetryTime, LPCSTR pInitParam, LPVOID pRes)

Definition for Basic

PviInitialize (ByVal Timeout As Long, ByVal RetryTime As Long, ByVal pInitParam As String, ByVal pRes As Long) As Long

PviXInitialize (ByRef phPvi As Long, ByVal Timeout As Long, ByVal RetryTime As Long, ByVal pInitParam As String, ByVal pRes As Long) As Long

Arguments

返回值

值为0（null）表示初始化工作正确进行。除了0（null）以外的值表示有错误，返回值与实际发生的错误的代码相对应。

说明

PviInitialize或PviXInitialize函数初始化了PVICOM接口，建立了一个PVICOM 通信实例，并启动了通信实例（客户端）与PVI管理器（服务器）的注册。一旦注册，通信实例（客户端）和PVI管理器（服务器）之间的通信连接就被打开。应该注意的是，客户端的注册只是启动。因此，从该功能返回并不能保证 客户机/服务器的稳定 通信。PVICOM通信实例可以 在 应用程序的 全局事件的帮助下发出通信连接的当前状态  。但要做到这一点，必须  在调用PviInitialize或PviXInitialize函数后， 用 PviSetGlobEventMsg 或PviXSetGlobEventMsg函数 激活所需的全局事件 。

与函数 "PviInitialize "不同，"PviXInitialize "可以被多次调用。每次调用都会建立一个新的通信实例。这允许一个PVICOM应用程序能够与不同计算机上的几个PVI管理器进行通信。如果用PviXInitialize设置了一个通信实例，那么随后必须用实例句柄（PviX...）调用PVICOM函数。参见 有无实例句柄的函数 部分。

如果初始化函数PviInitialize（或PviXInitialize）没有报告错误，那么发送请求基本上可以立即开始（请求和响应）。如果此时通信连接没有激活，那么所有的请求都在通信实例中缓冲。

初始化参数。

各个初始化参数在字符串中使用参数代码进行区分。

<ParameterName> = ["]<ParameterValue>["]

如果一个参数值有非字母数字的字符，则必须用（"..."）引号输入。各个参数条目之间至少要有一个空格。

Visual C++的例子

应用程序和PVI管理器在同一台计算机上。

#include <PviCom.h>
int Initialize (HWND hWnd)
{
    int Error;
    // Create and initialize communication instance:
    Error = PviInitialize (0, 0, "COMT=4 LM=1000", NULL);
    if (Error != 0)
        return (Error);
    // Set global Event ARRANGE to generate PVI objects:
    Error = PviSetGlobEventMsg (POBJ_EVENT_PVI_ARRANGE, hWnd, WM_USER+1, 0);
    if (Error != 0)
        return (Error);
    return (0);
}
int Deinitialize ()
{
    int Error;
    // Free communication instance:
    Error = PviDeinitialize ();
    return (Error);
}

在这里，应用程序应该与两个PVI管理器通信，其中第一个PVI管理器在同一台计算机上，第二个PVI管理器在另一台计算机上。

#include <PviCom.h>
DWORD hPvi1 = 0;
DWORD hPvi2 = 0;
int Initialize (HWND hWnd)
{
    int Error;
    // Create and initialize communication instance 1:
    Error = PviXInitialize (&hPvi1, 6, 0, "", NULL);
    if (Error != 0)
        return (Error);
    // Set global Event ARRANGE to generate PVI objects for manager 1:
    Error = PviXSetGlobEventMsg (hPvi1, POBJ_EVENT_PVI_ARRANGE, hWnd, WM_USER+1, 0);
    if (Error != 0)
        return (Error);
    // Create and initialize communication instance 2:
    Error = PviXInitialize (&hPvi2, 8, 0, "IP=10.43.50.62 PN=20001", NULL);
    if (Error != 0)
        return (Error);
    // Set global Event ARRANGE to generate PVI objects for manager 2:
    Error = PviXSetGlobEventMsg (hPvi2, POBJ_EVENT_PVI_ARRANGE, hWnd, WM_USER+2, 0);
    if (Error != 0)
        return (Error);
    return (0);
}
int Deinitialize ()
{
    int Error;
    int LastError = 0;
    if (hPvi1 != 0)
    {
        // Free communication instance 1:
        Error = PviXDeinitialize (hPvi1);
        if (Error != 0)
            LastError = Error;
        else
            hPvi1 = 0;
    }
    if (hPvi2 != 0)
    {
        // Free communication instance 2:
        Error = PviXDeinitialize (hPvi2);
        if (Error != 0)
            LastError = Error;
        else
            hPvi2 = 0;
    }
    return (LastError);
}