?? 3.虛擬儀器系統(tǒng)io接口軟件.txt
字號:
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 資源查尋到
錯誤代碼:
VI_ERROR_INV_SESSION vi(句柄)不能標識正當對話通道
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_INV_EXPR 查找表達式不規(guī)范
VI_ERROR_RSRC_NFOUND 查找表達式無法與資源名匹配
4) 描述:該操作用于查詢資源名與表達式相匹配的資源,并確定資源位置。
5) 相關項:參見viAttachRsrc()、viOpen()。
6) 實現(xiàn)要求:輸出參數(shù)accessLink應含所有相匹配的資源個數(shù)。
2、 viOpen(sesn,rsrcName,accessMode,timeout,vi)
1) 目標:打開特定資源的對話通道
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
sesn 輸入 ViSession VISA資源管理器
rsrcName 輸入 ViRsrc 資源名
accessMode 輸入 ViAccessMode 資源存取鎖定模式
timeout 輸入 ViUInt32 操作超時值
vi 輸出 ViPSession 對話通道標識符(句柄)
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 對話通道打開完成
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_INV_RSRC_NAME 資源名語法錯誤
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_INV_ACC_MODE 不合法的存取模式
VI_ERROR_NSUP_ACC_MODE 存取模式不被支持
VI_ERROR_RSRC_NFOUND 系統(tǒng)中未能找到該資源
VI_ERROR_TMO 操作超時
4) 描述:該操作用于開啟特定資源的一個對話通道,它返回的對話通道標識符可
作為以后操作的軟件句柄。參數(shù)中的accessMode應在幾種存取模式中選取(
VI_NO_LOCK、VI_EXCLUSIVE_LOCK、VI_NON_EXCLUSIVE_LOCK)。
5) 相關項:參見viClose()。
6) 實現(xiàn)要求:sesn參數(shù)一般用缺省VISA資源管理器viDefaultRM代入,因此在調(diào)
用viOpen()函數(shù)之前一般已先調(diào)用了viOpenDefaultRM()函數(shù)用于打開缺省的
資源管理器。
3、 viClose(vi)
1) 目標:關閉特定的對話通道
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 對話通道關閉完成
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_CLOSE_FAILED 無法釋放與該對話通道相關聯(lián)的內(nèi)存數(shù)據(jù)結構
4) 描述:該操作用于關閉與資源相關聯(lián)的對話通道,并釋放內(nèi)存數(shù)據(jù)。
5) 相關項:參見viOpen()。
6) 實現(xiàn)要求:當一個對話通道在執(zhí)行viClose()操作時,不僅應關閉該通道,
并應釋放所有通道的數(shù)據(jù)。
4、 viAttachRsrc(vi,rsrcName,refName)
1) 目標:通過對話通道,建立兩資源之間的關聯(lián)
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
rsrcName 輸入 ViRsrc 相關聯(lián)的資源名
refName 輸入/輸出 ViPRsrc 相關聯(lián)的資源別名
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 資源關聯(lián)完成
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_INV_RSRC_NAME 資源名語法錯誤
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_DUPLICATE refName參數(shù)中的資源已存在
_REF_NAME
VI_ERROR_ATTACH_REFUSED 資源無法被關聯(lián)
4) 描述:該操作用于關聯(lián)兩個資源,用vi標識的對話通道可以存取相關聯(lián)資源的
所有屬性與操作。
5) 相關項:參見viDetachRsrc()、viGetRsrcSession()。
6) 實現(xiàn)要求:資源間應通過關聯(lián)方式實現(xiàn)對話。
5、 viDetachRsrc(vi,refName)
1) 目標:取消資源之間的關聯(lián)
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
refName 輸入/輸出 ViPRsrc 相關聯(lián)的資源別名
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 取消資源關聯(lián)完成
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_RSRC_NFOUND 資源未能找到
VI_ERROR_INV_RSRC_NAME 資源名語法錯誤
4) 描述:該操作用于取消資源之間關聯(lián),一旦關聯(lián)取消,相關聯(lián)資源的所有屬性
與操作不能再被存取。
5) 相關項:參見viAttachRsrc()。
6) 實現(xiàn)要求:資源無法拒絕取消關聯(lián)的請求。
6、 viTerminate(vi,target,degree,jobId,immediate,flagFlushData)
1) 目標:請求VISA資源終止一個或所有對話通道的正常運行
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
target 輸入 ViBoolean 請求目標(資源或通道)
degree 輸入 ViUInt16 請求類型,正常類型有VI_ABORT、VI_RESET、VI_FAIL、
VI_KILL
jobId 輸入 ViJobId 操作標識符
immediate 輸入 ViBoolean 請求是否立即有效
flagFlushData 輸入 ViBoolean 資源是否放棄應用數(shù)據(jù)
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 請求服務完成
VI_SUCCESS_STATE_UNKNOWN 請求服務完成,但資源可能處于不一致狀態(tài)
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_INV_DEGREE 請求類型不合法
VI_ERROR_INV_JOB_ID 操作類型或標識符不合法
4) 描述:該操作用于請求資源去終止一個或所有對話通道的正常運行,請求類型
可分為VI_ABORT(退出)、VI_RESET(復位)、VI_FAIL(失敗)及VI_KILL(停止
所有資源操作)四種。
5) 相關項:參見VI_EVENT_ALERT事件描述。
6) 實現(xiàn)要求:當VISA資源激活viTerminate()操作時,資源不能進行其它操作
。
7、 viGetAttribute(vi,attribute,attrState)
viGetRsrcAttribute(vi,rsrcName,attribute,attrState)
1) 目標:獲取資源屬性狀態(tài)值
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
rsrcName 輸入 ViRsrc 資源名
attribute 輸入 ViAttr 資源屬性
attrState 輸出 ViPAttrState 資源屬性狀態(tài)值
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 獲取屬性完成
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_INV_RSRC_NAME 資源名語法錯誤
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_NSUP_ATTR 資源屬性未定義
4) 描述:viGetAttribute()取回當前資源屬性狀態(tài)值,而
viGetRsrcAttribute()
取回其它資源的公有屬性狀態(tài)值。
5) 相關項:參見viSetAttribute()、viSetrsrcAttribute()、viLock()、
viUnLock()。
6) 實現(xiàn)要求:無論資源鎖定狀態(tài)如何,viGetRsrcAttribute()操作都可以取回
資源公有屬性狀態(tài)值。
8、 viSetAttribute(vi,attribute,attrState)
viSetRsrcAttribute(vi,rsrcName,attribute,attrState)
1) 目標:設置資源屬性狀態(tài)值
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
rsrcName 輸入 ViRsrc 資源名
attribute 輸入 ViAttr 資源屬性
attrState 輸入 ViAttrState 資源屬性狀態(tài)值
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 屬性設置完成
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_INV_RSRC_NAME 資源名語法錯誤
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_NSUP_ATTR 資源屬性未定義
VI_ERROR_NSUP_ATTR_STATE 資源屬性狀態(tài)值不支持
VI_ERROR_NSUP_ATTR 資源屬性為只讀狀態(tài)
_READONLY
4) 描述:viSetAttribute()設置當前資源屬性狀態(tài)值,而
viSetRsrcAttribute()
設置其它資源的公有屬性狀態(tài)值。
5) 相關項:參見viGetAttribute()、viGetrsrcAttribute()、viLock()、
viUnLock()。
6) 實現(xiàn)要求:當資源處于鎖定狀態(tài)時,無法進行屬性狀態(tài)值設置。
9、 viLock(vi,lockType,shareType,timeout,lockId)
viLockRsrc(vi,rsrcName,lockType,shareType,timeout,lockId)
1) 目標:設置資源存取模式
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
rsrcName 輸入 ViRsrc 資源名
lockType 輸入 ViUInt16 鎖定類型(獨占或非獨占)
shareType 輸入 ViUInt16 鎖定共享類型
timeout 輸入 ViUInt32 操作超時值
lockId 輸入/輸出 ViPLock 當鎖定設置成功后,資源返回的唯一鎖定標識符
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 鎖定模式設置完成
VI_SUCCESS_SHARE_LOCK 鎖定模式設置完成,并被多個對話通道共享
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_INV_RSRC_NAME 資源名語法錯誤
VI_ERROR_RSRC_LOCKED 存取鎖定模式不支持特定操作
VI_ERROR_INV_LOCK_TYPE 鎖定模式不當
VI_ERROR_INV_LOCK_ID 鎖定標識符不當
VI_ERROR_NSHARABLE lockID不能用于非共享模式
VI_ERROR_LOCK_CHANGE 由于對話通道已被鎖定,不能從非獨占鎖定狀
_FAILED 態(tài)改變到獨占狀態(tài)
4) 描述:該操作用于設置資源鎖定模式,必須區(qū)分鎖定類型與共享類型。共享類
型的設置只對于獨占鎖定狀態(tài)有關,所有非獨占性鎖定狀態(tài)均為共享。
5) 相關項:參見viUnLock()、viUnLockRsrc()。
6) 實現(xiàn)要求:當鎖定模式為非獨占型時,shareType參數(shù)可忽略。
10、 viUnLock(vi,lockId)
viUnLockRsrc(vi,rsrcName,lockId)
1) 目標:取消資源存取模式
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
rsrcName 輸入 ViRsrc 資源名
lockId 輸入 ViLock 鎖定標識符
3) 返回狀態(tài)值:
完成代碼:
VI_SUCCESS 取消鎖定模式完成
VI_WARN_NON_EXCLUSIVE 調(diào)用成功,但資源仍被非獨占型鎖定
_LOCK
VI_WARN_EXCLUSIVE_LOCK 調(diào)用成功,但資源仍被獨占型鎖定
錯誤代碼:
VI_ERROR_INV_SESSION vi不能標識正當對話通道
VI_ERROR_INV_LOCK_ID 鎖定標識符不當
VI_ERROR_LOCK_NOWNER 鎖定并非來自于特定通道vi
4) 描述:該操作用于取消以前設置的資源鎖定模式。
5) 相關項:參見viLock()、viLockRsrc()。
6) 實現(xiàn)要求:注意不同的參數(shù)輸入對應于不同的返回狀態(tài)。
11、 viEnableEvent(vi,eventType,mechanism,context)
1) 目標:允許特定事件通知
2) 參數(shù)表:
參數(shù)名 輸入/輸出方向 數(shù)據(jù)類型 描述
vi 輸入 ViSession 對話通道標識符(句柄)
eventType 輸入 ViEventType 事件標識符
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -