Programming Interfaces
Agilent 81250 String Interface Library
24
Agilent 81250 Parallel Bit Error Ratio Tester, Programming Reference, March 2006
•
"; 7"
: override port, resolves to “127.0.0.1; 7”
•
"15.100.10.20; 2208"
: fully specified host
•
"mypc.bbn.hp.com; 2208"
: fully specified host
Call_HP81200
C Syntax
int HP81200_CDECL Call_HP81200(const char *Command,
char *Response,
int *BufferSize)
VB Syntax
VB_CALL_HP81200(ByVal Command As String,
ByRef Response As String,
ByRef BufferSize As Long) As Long
Description
Sends a command to the Agilent 81250 server and gets the response.
Parameters
Command
Any valid SCPI command, as described in
“Overview of
the SCPI Command Structure” on page 29
. If the command is a query,
the response and size of the response are returned.
Response
If the command is a query, the response is returned in
this buffer.
BufferSize
Size of the buffer allocated to receive the query result.
On return, the variable holds the actual number of valid bytes in the
buffer.
Return Value
Returns 0 on success and a negative number for server problems (use
“GetErrStr_HP81200” on page 25
to get an error message).
A positive number indicates that the command execution failed. Error
messages can be read from the corresponding error queue (see
“Error
Handling” on page 23
).
N O T E
The parameter
Response
is a buffer area provided by the caller. The
caller is responsible for reserving enough memory to hold the
response.
To prevent buffer overruns,
BufferSize
defines the maximum number
of bytes that can be written. This variable is set upon return to reflect
the number of bytes actually written. If the response does not fit into
the buffer, an error is returned.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com