GxDmmInitialize

Purpose

Initializes the driver for the board at the specified slot number. The function returns a handle that can be used with other GXDMM functions to program the board.

Syntax

GxDmmInitialize (nSlot, pnHandle, pnStatus)

Parameters

Name
Type
Comments
nSlot
SHORT
GX2065 board slot number on the PXI bus.
pnHandle
PSHORT
Returned handle for the board. The handle is set to zero on error and <> 0 on success.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The GxDmmInitialize function verifies whether or not the GX2065 board exists in the specified PXI slot. The function does not change any of the board settings. The function uses the HW driver to access and program the board.

The Marvin Test Solutions HW device driver is installed with the driver and is the default device driver. The function returns a handle that for use with other Counter functions to program the board. The function does not change any of the board settings.

The specified PXI slot number is displayed by the PXI/PCI Explorer applet that can be opened from the Windows Control Panel. You may also use the label on the chassis below the PXI slot where the board is installed. The function accepts two types of slot numbers:

The returned handle pnHandle is used to identify the specified board with other GX2065 functions.

The last set AC line frequency is stored within the GxDmm.ini file located in Windows Common App Data folder. The input AC line frequency is loaded from the GxDmm.ini file when first initializing the DMM after power up, if the file does not exist 60Hz is used.

Example

The following example initializes two GX2065 boards at slot 1 and 2.

 

SHORT nHandle1, nHandle2, nStatus;

GxDmmInitilize (1, &nHandle1, &nStatus);

GxDmmInitilize (2, &nHandle2, &nStatus);

if (nHandle1==0 || nHandle2==0)

{

printf(“Unable to Initialize the board”)

return;

}

 

See Also

GxDmmInitializeVisa, GxDmmReset, GxDmmSetLineFrequency, GxDmmGetErrorString