PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions > PviReadRequest, PviXReadRequest functions

Definition for C/C++

int PviReadRequest (DWORD LinkID, DWORD nAccess, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

int PviXReadRequest (DWORD hPvi, DWORD LinkID, DWORD nAccess, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

Definition for Basic

PviReadRequest (ByVal LinkID As Long, ByVal nAccess As Long, ByVal hResMsg As Long, ByVal ResMsgNo As Long, ByVal ResParam As Long) As Long

PviXReadRequest (ByVal hPvi As Long, ByVal LinkID As Long, ByVal nAccess 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 。
nAccess	In	访问类型
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

这个函数向一个链接对象发送一个读取请求。这个链接对象然后将请求传递给指定的进程对象。链接对象是用LinkID函数参数设置的。如果一个用户信息已经与读取请求一起被定义，那么一旦PVICOM通信实例收到来自PVI管理器的响应，它就会被执行。为了读取响应数据，应用程序需要调用 PviReadResponse 或PviXReadResponse函数。当使用 PVICALLBACK_DATA 类型的回调函数时，这并不适用。

一个访问类型被分配来选择如何进行读取访问。 PviReadArgumentRequest 或PviXReadArgumentRequest函数需要用于带有参数数据的读访问。