Interface IBaseMessage
Description
This interface provides the I/O functionality set found on the most common messaging resource types. You will probably find a more specific interface, such as IMessage, more useful than this interface.
IBaseMessage derives from IVisaSession.
Methods
|
Use of this method is discouraged. All the non-deprecated standard attributes are accessible via properties on the appropriate COM interfaces. |
|
|
Use of this method is discouraged. All the non-deprecated standard attributes are accessible via properties on the appropriate COM interfaces. |
|
|
Locks the resource. |
|
|
Unlocks the resource |
|
|
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. |
|
|
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. |
|
|
Asserts a software or hardware trigger dependent on the interface type. For a GPIB device, the device is addressed to listen, and then the GPIB GET command is sent. For a VXI device, if VI_ATTR_TRIG_ID is VI_TRIG_SW, then the device is sent the Word Serial Trigger command; if VI_ATTR_TRIG_ID is any other value, a hardware trigger is sent on the line corresponding to the value of that attribute. For GPIB and VXI software triggers, TRIG_PROT_DEFAULT is the only valid protocol. For VXI hardware triggers, TRIG_PROT_DEFAULT is equivalent to TRIG_PROT_SYNC. |
|
|
Performs an IEEE 488.1-style clear of the device. VXI uses the Word Serial Clear command, and GPIB uses the Selective Device Clear command. |
|
|
Reads a status byte of the service request from a service requester (the message-based device). For example, on the IEEE 488.2 interface, the message is read by polling devices; for other types of interfaces, a message is sent in response to a service request to retrieve status information. If the status information is only one byte long, the most significant byte is returned with the zero value. If the service requester does not respond in the actual timeout period, VI_ERROR_TMO is returned. |
Properties
|
A numeric version for this component. |
|
|
The VISA-defined version information for the specification version to which this component complies. |
|
|
The name of the hardware interface (GPIB, ASRL, etc.). |
|
|
The board number of the hardware interface. |
|
|
The type number of the hardware interface. |
|
|
The current locking state of the interface. |
|
|
The option string corresponding to the current state of the resource. |
|
|
The programmatic ID that can be used by COM to create this object. |
|
|
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. |
|
|
The session type string, such as "INSTR" or "INTFC". |
|
|
The ID number of the vendor of this software component. |
|
|
The name of the vendor of this software component. |
|
|
The I/O timeout in milliseconds for I/O communication on this resource session. |
|
|
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. |
|
|
The protocol type for I/O communication with the physical resource. |
|
|
Enables/disables sending the END signal on the last byte of a write. Most resource types have an out-of-band end signal to deterministically end reading. |
|
|
The ASCII character used to end reading. Setting this property does not enable/disable the use of this character; that is done by the TerminationCharacterEnabled property. The default character in most VISA implementations and most instruments is ASCII code 10 (linefeed). |
|
|
Enables/disables ending reads upon reception of the termination character. Enabling this property does not cause the termination character to be appended to writes. |