CalDmmInitialize

Purpose

Initializes the driver for the board at the specified address, which includes support for VISA resource. The function returns a handle that can be used with other CALDMM functions to program the DMM.

Syntax

CalDmmInitialize (sAddress, phHandle, plStatus)

Parameters

Name
Type
Comments
sAddress
STR
Address of DMM.
phHandle
PLONG
Returned handle for DMM access.
plStatus
PLONG
Returned status: 0 on success, negative number on failure.

Comments

The function verifies and establishes communication with the instrument at the specified address information. The address information can be PXI, GPIB, USB, WinSock or VISA resource string. This address string format is starting by the address type followed by a column and the address:  PXI | GPIB | WinSock | USB | Com | VISA : Address . The specifics of the Address string characteristics can be found in Writing a Standard Drivertopic in step 5. The function does not change any of the board settings.

The returned handle phHandle is used to identify the specified instrument with other driver functions.

Example

The following example initializes two DMMs at PXI address 0x1105 and GPIB board 1, address 15.

 

LONG lHandle1, lHandle2, lStatus;

 

CalDmmInitialize (“PXI:0x105”, &lHandle1 &lStatus);

CalDmmInitialize (“GPIB:1:15”, &lHandle2, &lStatus);

 

See Also

CalDmmGetError