Interface IGpibIntfc

Description

The IGpibIntfc interface provides the properties and methods specific to GPIB INTFC sessions, except for messaging capabilities. These properties and methods tend to be an extension to the properties and methods present in the IGpib interface.

IGpibIntfc derives from IVisaSession.

Methods

GetAttribute	Use of this method is discouraged. All the non-deprecated standard attributes are accessible via properties on the appropriate COM interfaces.
SetAttribute	Use of this method is discouraged. All the non-deprecated standard attributes are accessible via properties on the appropriate COM interfaces.
LockRsrc	Locks the resource.
UnlockRsrc	Unlocks the resource
Init	Opens the resource. This is the first method on IVisaSession or any of its derived interfaces to be called. In general, you will not call this method because you will use the Resource Manager to create resources.
Close	Closes the resource. Sending the resource's COM object's reference count to zero (and thus destroying the object) also executes a close, but this method may be useful for environments with garbage collection or other facilities that make object lifetimes non-deterministic.
Command	Writes GPIB command bytes on the bus. This operation attempts to write count number of bytes of GPIB commands to the interface bus associated with the session object. This operation returns only when the transfer terminates.
ControlATN	Controls the state of the GPIB ATN interface line, and optionally the active controller state of the local interface board. This operation asserts or deasserts the GPIB ATN interface line according to the specified mode. The mode can also specify whether the local interface board should acquire or release Controller Active status. It is generally not necessary to use the ControlATN operation in most applications. Other operations such as Command and PassControl modify the ATN and/or CIC state automatically.
ControlREN	Controls the state of the GPIB REN interface line and, optionally, the remote/local state of the device. This operation asserts or deasserts the GPIB REN interface line according to the specified mode. The mode can also specify whether the device associated with this session should be placed in local state (before deasserting REN) or remote state (after asserting REN). This operation is valid only if the GPIB interface associated with the session object is currently the system controller. An INTFC resource implementation of ControlREN for a GPIB System supports the modes GPIB_REN_DEASSERT, GPIB_REN_ASSERT, and GPIB_REN_ASSERT_LLO.
PassControl	Tells the GPIB device at the specified address to become controller in charge (CIC). This operation passes controller in charge status to the device indicated by primAddr and secAddr, and then deasserts the ATN line. This operation assumes that the targeted device has controller capability.
SendIFC	Pulses the interface clear line (IFC) for at least 100 microseconds. This operation asserts the IFC line and becomes controller in charge (CIC). The local board must be the system controller.

Properties

ComponentVersion	A numeric version for this component.
SpecVersion	The VISA-defined version information for the specification version to which this component complies.
HardwareInterfaceName	The name of the hardware interface (GPIB, ASRL, etc.).
HardwareInterfaceNumber	The board number of the hardware interface.
HardwareInterfaceType	The type number of the hardware interface.
LockState	The current locking state of the interface.
OptionString	The option string corresponding to the current state of the resource.
ProgID	The programmatic ID that can be used by COM to create this object.
ResourceName	The VISA resource name of the currently open resource. This name is the canonical version of the resource name and therefore may vary from the resource string used to open/init the resource.
SessionType	The session type string, such as "INSTR" or "INTFC".
SoftwareManufacturerID	The ID number of the vendor of this software component.
SoftwareManufacturerName	The name of the vendor of this software component.
Timeout	The I/O timeout in milliseconds for I/O communication on this resource session.
LastStatus	The return value from the last method call on this interface. This property may be useful in Visual Basic, where positive return values, such as warnings and other non-error return values, cannot be retrieved. See the Return Values page for a list of positive return values.
AddressingState	Shows whether the specified GPIB interface is currently addressed to talk or listen, or is not addressed.
ATNState	Shows the current state of the GPIB ATN (ATtentioN) interface line.
DevStatusByte	Specifies the 488-style status byte of the local controller associated with this session. If this property is set and bit 6 (0x40) is set, this device or controller will assert a service request (SRQ) if it is defined for this interface.
CICState	Shows whether the specified GPIB interface is currently CIC (controller in charge).
HS488CBLLength	Specifies the total number of meters of GPIB cable used in the specified GPIB interface. If HS488 is not implemented, querying this attribute should return the value GPIB_HS488_NIMPL. On these systems, trying to set this attribute value will return the error E_VISA_NSUP_ATTR_STATE.
NDACState	Shows the current state of the GPIB NDAC (Not Data ACcepted) interface line.
PrimaryAddress	Primary address of the local GPIB controller used by the given session.
RENState	Shows the current state of the GPIB REN (Remote ENable) interface line.
SecondaryAddress	Secondary address of the local GPIB controller used by the given session.
SRQState	Shows the current state of the GPIB SRQ (Service ReQuest) interface line.
SysControlState	Shows whether the specified GPIB interface is currently the system controller. In some implementations, this attribute may be modified only through a configuration utility. On these systems, this attribute is read only (RO).