_viSetTimeout
Sets the VISA timeout in MILISECONDS
#include <Visa.au3>
_viSetTimeout($h_session, $i_timeout_ms)
Параметры
$h_session | A VISA descriptor (STRING) OR a VISA session handle (INTEGER). See the Remarks of the _viExecCommand for more info. |
$i_timeout_ms |
The timeout IN MILISECONDS for VISA operations (mainly for GPIB queries) If you set it to 0 the tiemouts are DISABLED. If you set it to "INF" the VISA operations will NEVER timeout. Be careful with this as it could easly hung your program ifv your instrument does not respond to one of your queries. Depending on the bus type (GPIB, TCP, etc) the timeout might not be set to the exact value that you request. Instead the closest valid timeout bigger than the one that you requested will be used. |
Возвращаемое значение
Успех: | Returns 0 |
Ошибка: | Returns -1 if the VISA DLL could not be open or a NON ZERO value representing the VISA error code (see the VISA programmer's guide). |
Примечания
Most of the time it is not necessary to call this function, as _viExecCommand has a third OPTIONAL parameter $i_timeout_ms which can also be used to set the VISA timeout.См. также
_viSetAttribute, _viExecCommand, _viOpen, _viCloseПример
;- This assumes that you have instrument set to GPIB address 3.
; If you have an instrument in a different address change "GPIB::3::0" to the
; corresponding descriptor. Do the same for the call to _viOpen
; It shows how to use the _viExecCommand function with a timeout or how to
; call _viSetTimeout instead.
#include <Visa.au3>
Local $h_session = 0
; Query the ID of the instrument in GPIB address 3
MsgBox(4096, "Step 1", "Simple GPIB query with explicit TIMEOUT set")
Local $s_answer = _viExecCommand("GPIB::3::0", "*IDN?", 10000) ; 10 secs timeout
MsgBox(4096, "GPIB QUERY result", $s_answer) ; Show the answer
; This is the same as using the _viSetTimeout function first:
MsgBox(4096, "Step 2", "_vOpen + timeout using _viSetTimeout + GPIB query")
Local $h_instr = _viOpen(3)
_viSetTimeout($h_instr, 10000) ; 10000 ms = 10 secs
$s_answer = _viExecCommand($h_instr, "*IDN?") ; No need to set the timeout now
MsgBox(4096, "GPIB QUERY result", $s_answer) ; Show the answer
MsgBox(4096, "Step 3", "Close the Instrument connection using _viClose")
_viClose($h_instr) ; Close the instrument connection