PviRead, PviXRead functions

<< 点击显示目录 >>

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

PviRead, PviXRead functions

Definition for C/C++

int PviRead (DWORD LinkID, DWORD nAccess, LPVOID pArgData, LONG ArgDataLen, LPVOID pData, LONG DataLen)

int PviXRead (DWORD hPvi, DWORD LinkID, DWORD nAccess, LPVOID pArgData, LONG ArgDataLen, LPVOID pData, LONG DataLen)

Definition for Basic

PviRead (ByVal LinkID As Long, ByVal nAccess As Long, ByRef pArgData As Any, ByVal ArgDataLen As Long, ByRef pData As Any, ByVal DataLen As Long) As Long

PviXRead (ByVal hPvi As Long, ByVal LinkID As Long, ByVal nAccess As Long, ByRef pArgData As Any, ByVal ArgDataLen As Long, ByRef pData As Any, ByVal DataLen As Long) As Long

Arguments

Argument

I/O

说明

hPvi

In

来自 PviXInitialize 函数的实例句柄

LinkID

In

来自 PviCreateResponse, PviLinkResponse 或PviXCreateResponse, PviXLinkResponse函数链接ID

nAccess

In

访问类型

pArgData

In

指向参数数据的指针,用于写入访问

ArgDataLen

In

参数数据的长度

= 0:没有参数数据存在。可以为pArgData指定0(零)。

pData

Out

指向用于记录响应数据的用户数据缓冲区的指针

DataLen

In

用户数据缓冲区的长度,以字节为单位

= 0:不复制响应数据。可以为pData指定0(零)。

Return value

如果数值不是0,则表明有错误。错误代码会作为一个值返回。如果在执行读取请求时发生错误,或者 通信实例 和PVI管理器之间的连接  中断(通信超时),或者发生应用错误,则报告错误  。值 "0 "表示已经执行了读取请求,用户数据缓冲区中的响应数据是有效的。

Description

该函数是 PviReadArgumentRequest / PviReadResponse 或PviXReadArgumentRequest / PviXReadResponse功能 的同步变量 参见 异步和同步函数 部分。