next up previous contents
Next: PM_CL_STW Up: Function Specific Structures Previous: PM_CL_SEQ   Contents

PM_CL_SFQ

  struct PM_CL_SFQ

  {
    SRVD sd;
    int  SamplesPerCycle;
  };
This structure is used with the CL_SFQ_SVC RPC function call to request that a ZY change the number of samples per cycle of data. The Analog to Digital converter (ADC) on the ZY uses this value to determine how many times to sample a single cycle of the measured signal. The ADC on the ZY is capable of making 16-bit conversions at up to 100 KHz. This sampling rate will be exceeded if the product of the reference frequency and the samples-per-cycle value exceeds 100000, so the ZY will reject any attempt to set a value that is too high.

Members:
sd.Name

The name of the ZY.
sd.Flags

Out: The following two flags control the behavior of CL_SFQ_SVC. They are mutually exclusive:
CL_SFQ_READ If this flag is set, CL_SFQ_SVC requests the current value of the samples-per-cycle parameter on the ZY.
CL_SFQ_SET If this flag is set, CL_SFQ_SVC sends a new value for the samples-per-cycle parameter to the ZY.
In: Error word. If 0, the data member sd.ErrorMsg will point to an error message.
sd.ErrorMsg

Out: Not used. In: If sd.Flags is set to 0, this will contain an error message.
sd.TID

Out: Not used. In: The Transaction ID of this action.
sd.TS

Out: Not used. In: The time stamp for this event. This time stamp is taken when the command completes on the ZY.
SamplesPerCycle

Out: If flag CL_SFQ_SET is set, then this value holds the new samples-per-cycle value that the ZY should use. In: if sd.Flags is greater than 0, then this value is the new or current value for the samples-per-cycle parameter on the named ZY.

See also: CL_SFQ_SVC, PM_CL_CYC, PM_CL_IFF
next up previous contents
Next: PM_CL_STW Up: Function Specific Structures Previous: PM_CL_SEQ   Contents
Ramon E. Creager 2002-03-11