Gx6616Initialize

Purpose

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

Syntax

Gx6616Initialize (nSlot, pnHandle, pnStatus)

Parameters

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

Comments

The Gx6616Initialize function verifies whether or not the GX6616 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:

        A combination of chassis number (chassis # x 256) with the chassis slot number. For example 0x105 (chassis 1 slot 5).

        Legacy nSlot as used by earlier versions of HW/VISA. The slot number contains no chassis number and can be changed using the PXI/PCI Explorer applet (1-255).

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

Example

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

 

SHORT nHandle1, nHandle2, nStatus;

Gx6616Initilize (1, &nHandle1, &nStatus);

Gx6616Initilize (2, &nHandle2, &nStatus);

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

    { printf("Unable to Initialize the board")

      return;

}

 

See Also

Gx6616InitializeVisa, Gx6616Reset, Gx6616GetErrorString