PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions > *PviReadArgumentRequest, PviXReadArgumentRequest functions

Definition for C/C++

int PviReadArgumentRequest (DWORD LinkID, DWORD nAccess, LPVOID pArgData, LONG ArgDataLen, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

int PviXReadArgumentRequest (DWORD hPvi, DWORD LinkID, DWORD nAccess, LPVOID pArgData, LONG ArgDataLen, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

Definition for Basic

PviReadArgumentRequest (ByVal LinkID As Long, ByVal nAccess As Long, ByRef pArgData As Any, ByVal ArgDataLen As Long, ByVal hResMsg As Long, ByVal ResMsgNo As Long, ByVal ResParam As Long) As Long

PviXReadArgumentRequest (ByVal hPvi As Long, ByVal LinkID As Long, ByVal nAccess As Long, ByRef pArgData As Any, ByVal ArgDataLen 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	访问类型
pArgData	In	指向参数数据的指针，用于写入访问
ArgDataLen	In	参数数据的长度 = 0：没有参数数据存在。可以为pArgData指定0（零）。
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

这个函数的工作原理类似于 PviReadRequest 或PviXReadRequest函数。唯一的区别是，读取访问的参数数据可以用PviReadArgumentRequest或PviXReadArgumentRequest指定。因此，需要读取请求的参数数据的访问类型（例如 OBJ_ACC_UPLOAD）需要使用这个函数。