PviGetResponseInfo, PviXGetResponseInfo functions

<< 点击显示目录 >>

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

PviGetResponseInfo, PviXGetResponseInfo functions

Definition for C/C++

int PviGetResponseInfo (WPARAM wParam, LPARAM* pParam, LPDWORD pDataLen, T_RESPONSE_INFO* pInfo, DWORD InfoLen)

int PviGetXResponseInfo (DWORD hPvi, WPARAM wParam, LPARAM* pParam, LPDWORD pDataLen, T_RESPONSE_INFO* pInfo, DWORD InfoLen)

Definition for Basic

PviGetResponseInfo (ByVal wParam As Long, ByRef pParam As Long, ByRef pDataLen As Long, ByRef pInfo As T_RESPONSE_INFO, ByVal InfoLen As Long) As Long

PviXGetResponseInfo (ByVal hPvi As Long, ByVal wParam As Long, ByRef pParam As Long, ByRef pDataLen As Long, ByRef pInfo As T_RESPONSE_INFO, ByVal InfoLen As Long) As Long

Arguments

Argument

I/O

说明

hPvi

In

来自 PviXInitialize 函数的实例句柄

wParam

In

指向响应或事件数据的指针。 必须指定用户信息中的 "wParam "参数

pParam

Out

指向用于记录用户参数的变量的指针。在32位PVI版本(PviCom.dll)中,用户参数的大小为4字节,在64位PVI版本(PviCom64.dll)中为8字节。如果不需要用户参数,那么可以指定一个空指针。

pDataLen

Out

指向一个变量的指针(4字节),用于记录响应或事件数据的长度。如果不需要长度,那么可以指定一个空指针。

作为响应数据长度的值0(零)意味着没有响应数据存在。

pInfo

Out

指向用户缓冲区(T_RESPONSE_INFO结构)的指针,额外的信息在这里被复制。如果不需要额外的信息,那么可以指定一个空指针。

InfoLen

In

用户缓冲区 "pInfo "的大小,字节数

Return value

如果数值不是0,则表明有错误。错误代码被作为一个值返回。这个函数只返回被调用时发生的错误,例如用户错误(例如非法的函数参数)或错误1205(没有响应数据)。影响请求本身的错误只能通过适当的响应函数或从 RESPONSE_INFO结构中读取 。

如果在收到用户信息和调用函数PviGetResponseInfo或PviXGetResponseInfo之间删除了响应或事件数据(例如PviUnlink),该函数会返回错误12055。因此建议轮询错误1205,在这种情况下,跳过对用户信息的进一步处理(响应函数调用)。

Description

应用程序可以使用PviGetResponseInfo或PviXGetResponseInfo函数来读取  收到 用户消息后的响应或事件数据的信息  。该函数只能在相应的响应函数被调用之前执行。这个函数不能与同步函数一起使用。当使用 PVICALLBACK_DATA 类型的回调函数  作为用户消息 时,也不需要调用该函数