ClassPrefix Get Next Coercion Record

IVI Inherent Function

To form the ClassPrefix VI name, use the prefix of the class driver that you are working with. For example, if you are working with the IviDmm class driver, use the prefix IviDmm to create the correct VI name, IviDmm Get Next Coercion Record.

This VI obtains the coercion information associated with the IVI session. It retrieves and clears the oldest instance in which the specific driver coerced a value you specified to another value.

If you set the ClassPrefix Record Value Coercions property to TRUE, the specific driver keeps a list of all coercions it makes on ViInt32 or ViReal64 values you pass to instrument driver VIs. You use this VI to retrieve information from that list.

The VI returns an empty string in the Coercion Record parameter if no coercion records remain for the session.

instrument handle The instrument handle that you obtain from the ClassPrefix Initialize or ClassPrefix Initialize With Options VI. The handle identifies a particular instrument session.

	error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the ClassPrefix Initialize or ClassPrefix Initialize With Options VI. The handle identifies a particular instrument session.

	coercion record Returns the next coercion record for the IVI session. If there are no coercion records, the VI returns an empty string.
	error out The error out cluster passes error or warning information out of a VI to be used by other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.