PVI通信 > PVI帮助信息 > PVI base system > PVICOM interface > PVICOM functions > PviWriteRequest, PviXWriteRequest functions

Definition for C/C++

int PviWriteRequest (DWORD LinkID, DWORD nAccess, LPVOID pData, LONG DataLen, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

int PviXWriteRequest (DWORD hPvi, DWORD LinkID, DWORD nAccess, LPVOID pData, LONG DataLen, LPVOID hResMsg, DWORD ResMsgNo, LPARAM ResParam)

Definition for Basic

PviWriteRequest (ByVal LinkID As Long, ByVal nAccess As Long, ByRef pData As Any, ByVal DataLen As Long, ByVal hResMsg As Long, ByVal ResMsgNo As Long, ByVal ResParam As Long) As Long

PviXWriteRequest (ByVal hPvi As Long, ByVal LinkID As Long, ByVal nAccess As Long, ByRef pData As Any, ByVal DataLen 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	访问类型
pData	In	写入数据的指针
DataLen	In	写入数据的长度（字节 = 0：不存在写数据。可以为pData指定0（零）。
hResMsg	In	为该函数调用发出响应信号的用户信息的定义（请求和响应）。 = 0（空）。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管理器的响应，它就会被执行。为了读取响应数据，应用程序需要调用 PviWriteResponse 或PviXWriteResponse函数。当使用 PVICALLBACK_DATA 类型的回调函数时，这并不适用。

一个访问类型被分配给每个写入请求，以选择写入访问的方式。