Measurements

Functions
EXPORT int	PwrSnsr_MeasurePower (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Return average power using a default instrument configuration in Modulated Mode and dBm units. Instrument remains stopped in Modulated Mode after a measurement. More...
EXPORT int	PwrSnsr_FetchCWPower (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the most recently acquired CW power. More...
EXPORT int	PwrSnsr_MeasureVoltage (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Return average voltage using a default instrument configuration in Modulated Mode and volts units. Instrument remains stopped in Modulated Mode after a measurement. More...
EXPORT int	PwrSnsr_ReadWaveformMinMax (SessionID Vi, const char *Channel, int MinWaveformBufferSize, float MinWaveform[], int *MinWaveformActualSize, int MaxWaveformBufferSize, float MaxWaveform[], int *MaxWaveformActualSize, int WaveformArrayBufferSize, float WaveformArray[], int *WaveformArrayActualSize)
	Initiates an acquisition on all enabled channels, waits (up to MaxTime) for the acquisition to complete, and returns the min/max waveforms for this channel. Call FetchMinMaxWaveform to obtain the min/max waveforms for other channels. More...
EXPORT int	PwrSnsr_ReadWaveform (SessionID Vi, const char *Channel, int WaveformArrayBufferSize, float WaveformArray[], int *WaveformArrayActualSize)
	Initiates an acquisition on all enabled channels, waits (up to MaxTime) for the acquisition to complete, and returns the waveform for this channel. Call FetchWaveform to obtain the waveforms for other channels. More...
EXPORT int	PwrSnsr_FetchWaveformMinMax (SessionID Vi, const char *Channel, int MinWaveformBufferSize, float MinWaveform[], int *MinWaveformActualSize, int MaxWaveformBufferSize, float MaxWaveform[], int *MaxWaveformActualSize, int WaveformArrayBufferSize, float WaveformArray[], int *WaveformArrayActualSize)
	Returns the previously acquired minimum and maximum waveforms for this specified channel. The acquisition must be made prior to calling this method. Call this method separately for each channel. More...
EXPORT int	PwrSnsr_FetchWaveform (SessionID Vi, const char *Channel, int WaveformArrayBufferSize, float WaveformArray[], int *WaveformArrayActualSize)
	Returns a previously acquired waveform for this channel. The acquisition must be made prior to calling this method. Call this method separately for each channel. More...
EXPORT int	PwrSnsr_FetchPowerArray (SessionID Vi, const char *Channel, float *PulsePeak, PwrSnsrCondCodeEnum *PulsePeakValid, float *PulseCycleAvg, PwrSnsrCondCodeEnum *PulseCycleAvgValid, float *PulseOnAvg, PwrSnsrCondCodeEnum *PulseOnValid, float *IEEETop, PwrSnsrCondCodeEnum *IEEETopValid, float *IEEEBottom, PwrSnsrCondCodeEnum *IEEEBottomValid, float *Overshoot, PwrSnsrCondCodeEnum *OvershootValid, float *Droop, PwrSnsrCondCodeEnum *DroopValid)
	Returns an array of the current automatic amplitude measurements performed on a periodic pulse waveform. More...
EXPORT int	PwrSnsr_FetchTimeArray (SessionID Vi, const char *Channel, float *Frequency, PwrSnsrCondCodeEnum *FrequencyValid, float *Period, PwrSnsrCondCodeEnum *PeriodValid, float *Width, PwrSnsrCondCodeEnum *WidthValid, float *Offtime, PwrSnsrCondCodeEnum *OfftimeValid, float *DutyCycle, PwrSnsrCondCodeEnum *DutyCycleValid, float *Risetime, PwrSnsrCondCodeEnum *RisetimeValid, float *Falltime, PwrSnsrCondCodeEnum *FalltimeValid, float *EdgeDelay, PwrSnsrCondCodeEnum *EdgeDelayValid, float *Skew, PwrSnsrCondCodeEnum *SkewValid)
	Returns an array of the current automatic timing measurements performed on a periodic pulse waveform. More...
EXPORT int	PwrSnsr_FetchCWArray (SessionID Vi, const char *Channel, float *PeakAverage, PwrSnsrCondCodeEnum *PeakAverageValid, float *PeakMax, PwrSnsrCondCodeEnum *PeakMaxValid, float *PeakMin, PwrSnsrCondCodeEnum *PeakMinValid, float *PeakToAvgRatio, PwrSnsrCondCodeEnum *PeakToAvgRatioValid)
	Returns the current average, maximum, minimum powers or voltages and the peak-to-average ratio of the specified channel. Units are the same as the channel units. Note the peak-to-average ratio and marker ratio are returned in dB for logarithmic channel units, and percent for all other channel units. More...
EXPORT int	PwrSnsr_FetchRiseTime (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the interval between the first signal crossing of the proximal line to the first signal crossing of the distal line. More...
EXPORT int	PwrSnsr_FetchWidth (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the pulse width, i.e. the interval between the first and second signal crossings of the mesial line. More...
EXPORT int	PwrSnsr_FetchPulsePeak (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the peak amplitude during the pulse. More...
EXPORT int	PwrSnsr_FetchPulseOnAverage (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Average power of the ON portion of the pulse. More...
EXPORT int	PwrSnsr_FetchPulseCycleAvg (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the average power of the entire pulse. More...
EXPORT int	PwrSnsr_FetchPRF (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the number of cycles of a repetitive signal that take place in one second (Pulse Repetition Frequency). More...
EXPORT int	PwrSnsr_FetchPeriod (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the interval between two successive pulses. (Reciprocal of the Pulse RepetitionFrequency) More...
EXPORT int	PwrSnsr_FetchOvershoot (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the difference between the distortion following a major transition and the IEEE top line in dB or percent, depending on the channel units. More...
EXPORT int	PwrSnsr_FetchOfftime (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the time a repetitive pulse is off. (Equal to the pulse period minus the pulsewidth). More...
EXPORT int	PwrSnsr_FetchIEEETop (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the IEEE-defined top line, i.e. the portion of a pulse waveform which represents the second nominal state of a pulse. More...
EXPORT int	PwrSnsr_FetchIEEEBottom (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the IEEE-define base line, i.e. The two portions of a pulse waveform which represent the first nominal state from which a pulse departs and to which it ultimately returns. More...
EXPORT int	PwrSnsr_FetchFallTime (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the interval between the last signal crossing of the distal line to the last signalcrossing of the proximal line. More...
EXPORT int	PwrSnsr_FetchEdgeDelay (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns time offset from the trigger reference to the first mesial transition level of either slope on the waveform. More...
EXPORT int	PwrSnsr_FetchDutyCycle (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
	Returns the ratio of the pulse on-time to off-time. More...
EXPORT int	PwrSnsr_ReadCWPower (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *IsValid, float *Val)
EXPORT int	PwrSnsr_ReadCWArray (SessionID Vi, const char *Channel, float *PeakAverage, PwrSnsrCondCodeEnum *PeakAverageValid, float *PeakMax, PwrSnsrCondCodeEnum *PeakMaxValid, float *PeakMin, PwrSnsrCondCodeEnum *PeakMinValid, float *PeakToAvgRatio, PwrSnsrCondCodeEnum *PeakToAvgRatioValid)
	Returns the current average, maximum, minimum powers or voltages and the peak-to-average ratio of the specified channel. Units are the same as the channel's units. Note the peak-to-average ratio and marker ratio are returned in dB for logarithmic channel units, and percent for all other channel units. More...
EXPORT int	PwrSnsr_ReadPowerArray (SessionID Vi, const char *Channel, float *PulsePeak, PwrSnsrCondCodeEnum *PulsePeakValid, float *PulseCycleAvg, PwrSnsrCondCodeEnum *PulseCycleAvgValid, float *PulseOnAvg, PwrSnsrCondCodeEnum *PulseOnValid, float *IEEETop, PwrSnsrCondCodeEnum *IEEETopValid, float *IEEEBottom, PwrSnsrCondCodeEnum *IEEEBottomValid, float *Overshoot, PwrSnsrCondCodeEnum *OvershootValid, float *Droop, PwrSnsrCondCodeEnum *DroopValid)
	Returns an array of the current automatic amplitude measurements performed on a periodic pulse waveform. More...
EXPORT int	PwrSnsr_ReadTimeArray (SessionID Vi, const char *Channel, float *Frequency, PwrSnsrCondCodeEnum *FrequencyValid, float *Period, PwrSnsrCondCodeEnum *PeriodValid, float *Width, PwrSnsrCondCodeEnum *WidthValid, float *Offtime, PwrSnsrCondCodeEnum *OfftimeValid, float *DutyCycle, PwrSnsrCondCodeEnum *DutyCycleValid, float *Risetime, PwrSnsrCondCodeEnum *RisetimeValid, float *Falltime, PwrSnsrCondCodeEnum *FalltimeValid, float *EdgeDelay, PwrSnsrCondCodeEnum *EdgeDelayValid, float *Skew, PwrSnsrCondCodeEnum *SkewValid)
	Returns an array of the current automatic timing measurements performed on a periodic pulse waveform. More...
EXPORT int	PwrSnsr_ReadDutyCycle (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the ratio of the pulse on-time to off-time. More...
EXPORT int	PwrSnsr_ReadEdgeDelay (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns time offset from the trigger reference to the first mesial transition level of either slope on the waveform. More...
EXPORT int	PwrSnsr_ReadFallTime (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the interval between the last signal crossing of the distal line to the last signal crossing of the proximal line. More...
EXPORT int	PwrSnsr_ReadIEEEBottom (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the IEEE-define base line, i.e. The two portions of a pulse waveform which represent the first nominal state from which a pulse departs and to which it ultimately returns. More...
EXPORT int	PwrSnsr_ReadIEEETop (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the IEEE-defined top line, i.e. the portion of a pulse waveform which represents the second nominal state of a pulse. More...
EXPORT int	PwrSnsr_ReadOfftime (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the time a repetitive pulse is off. (Equal to the pulse period minus the pulse width). More...
EXPORT int	PwrSnsr_ReadOvershoot (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the difference between the distortion following a major transition and the IEEE top line in dB or percent, depending on the channel units. More...
EXPORT int	PwrSnsr_ReadPeriod (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the interval between two successive pulses. More...
EXPORT int	PwrSnsr_ReadPRF (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the number of cycles of a repetitive signal that take place in one second (Pulse Repetition Frequency). More...
EXPORT int	PwrSnsr_ReadPulseCycleAvg (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the average power of the entire pulse. More...
EXPORT int	PwrSnsr_ReadPulseOnAverage (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Average power of the ON portion of the pulse. More...
EXPORT int	PwrSnsr_ReadPulsePeak (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the peak amplitude during the pulse. More...
EXPORT int	PwrSnsr_ReadRiseTime (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the interval between the first signal crossing of the proximal line to the first signal crossing of the distal line. More...
EXPORT int	PwrSnsr_ReadWidth (SessionID Vi, const char *Channel, PwrSnsrCondCodeEnum *CondCode, float *Val)
	Returns the pulse width, i.e. the interval between the first and second signal crossings of the mesial line. More...

Detailed Description

General measurement functions

Function Documentation

PwrSnsr_FetchCWArray()

EXPORT int PwrSnsr_FetchCWArray	(	SessionID	Vi,
		const char *	Channel,
		float *	PeakAverage,
		PwrSnsrCondCodeEnum *	PeakAverageValid,
		float *	PeakMax,
		PwrSnsrCondCodeEnum *	PeakMaxValid,
		float *	PeakMin,
		PwrSnsrCondCodeEnum *	PeakMinValid,
		float *	PeakToAvgRatio,
		PwrSnsrCondCodeEnum *	PeakToAvgRatioValid
	)

Returns the current average, maximum, minimum powers or voltages and the
peak-to-average ratio of the specified channel. Units are the same as the
channel units. Note the peak-to-average ratio and marker ratio are returned
in dB for logarithmic channel units, and percent for all other channel units.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
PeakAverage	Average power of the peak power envelope.
PeakAverageValid	Condition code.
PeakMax	maximum power of the peak power envelope.
PeakMaxValid	Condition code.
PeakMin	Minimum power of the peak power envelope.
PeakMinValid	Condition code.
PeakToAvgRatio	Peak to average ratio.
PeakToAvgRatioValid	Condition code.

Returns

Success (0) or error code.

PwrSnsr_FetchCWPower()

EXPORT int PwrSnsr_FetchCWPower	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the most recently acquired CW power.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement.
Val	CW power in channel units.

Returns

Success (0) or error code.

PwrSnsr_FetchDutyCycle()

EXPORT int PwrSnsr_FetchDutyCycle	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the ratio of the pulse on-time to off-time.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchEdgeDelay()

EXPORT int PwrSnsr_FetchEdgeDelay	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns time offset from the trigger reference to the first mesial transition level of either slope on the waveform.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid
Val

Returns

Success (0) or error code.

PwrSnsr_FetchFallTime()

EXPORT int PwrSnsr_FetchFallTime	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the interval between the last signal crossing of the distal line to the last signalcrossing of the proximal line.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchIEEEBottom()

EXPORT int PwrSnsr_FetchIEEEBottom	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the IEEE-define base line, i.e. The two portions of a pulse waveform which represent the first nominal state from which a pulse departs and to which it ultimately returns.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchIEEETop()

EXPORT int PwrSnsr_FetchIEEETop	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the IEEE-defined top line, i.e. the portion of a pulse waveform which represents the second nominal state of a pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchOfftime()

EXPORT int PwrSnsr_FetchOfftime	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the time a repetitive pulse is off. (Equal to the pulse period minus the pulsewidth).

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchOvershoot()

EXPORT int PwrSnsr_FetchOvershoot	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the difference between the distortion following a major transition and the IEEE top line in dB or percent, depending on the channel units.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchPeriod()

EXPORT int PwrSnsr_FetchPeriod	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the interval between two successive pulses. (Reciprocal of the Pulse RepetitionFrequency)

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchPowerArray()

EXPORT int PwrSnsr_FetchPowerArray	(	SessionID	Vi,
		const char *	Channel,
		float *	PulsePeak,
		PwrSnsrCondCodeEnum *	PulsePeakValid,
		float *	PulseCycleAvg,
		PwrSnsrCondCodeEnum *	PulseCycleAvgValid,
		float *	PulseOnAvg,
		PwrSnsrCondCodeEnum *	PulseOnValid,
		float *	IEEETop,
		PwrSnsrCondCodeEnum *	IEEETopValid,
		float *	IEEEBottom,
		PwrSnsrCondCodeEnum *	IEEEBottomValid,
		float *	Overshoot,
		PwrSnsrCondCodeEnum *	OvershootValid,
		float *	Droop,
		PwrSnsrCondCodeEnum *	DroopValid
	)

Returns an array of the current automatic amplitude measurements performed on
a periodic pulse waveform.

Measurements performed are: peak amplitude during
the pulse, average amplitude over a full cycle of the pulse waveform, average
amplitude during the pulse, IEEE top amplitude, IEEE bottom amplitude, and overshoot.
Units are the same as the channel's units.

Note the pulse overshoot is returned in dB for logarithmic channel units,
and percent for all other units. Also, the pulse ?ON interval used for peak
and average calculations is defined by the SENSe:PULSe:STARTGT and :ENDGT time gating settings.
A full pulse (rise and fall) must be visible on the display to make average
and peak pulse power measurements, and a full cycle of the waveform must be
visible to calculate average cycle amplitude.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
PulsePeak	The peak amplitude during the pulse.
PulsePeakValid	Condition code.
PulseCycleAvg	Average cycle amplitude.
PulseCycleAvgValid	Condition code.
PulseOnAvg	Average power of the ON portion of the pulse.
PulseOnValid	Condition code.
IEEETop	The IEEE-defined top line, i.e. the portion of a pulse waveform, which represents the second nominal state of a pulse.
IEEETopValid	Condition code.
IEEEBottom	The IEEE-define base line, i.e. The two portions of a pulse waveform which represent the first nominal state from which a pulse departs and to which it ultimately returns.
IEEEBottomValid	Condition code.
Overshoot	The difference between the distortion following a major transition and the IEEE top line in dB or percent,depending on the channel units.
OvershootValid	Condition code.
Droop	Pulse droop.
DroopValid	Condition code.

Returns

Success (0) or error code.

PwrSnsr_FetchPRF()

EXPORT int PwrSnsr_FetchPRF	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the number of cycles of a repetitive signal that take place in one second (Pulse Repetition Frequency).

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchPulseCycleAvg()

EXPORT int PwrSnsr_FetchPulseCycleAvg	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the average power of the entire pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchPulseOnAverage()

EXPORT int PwrSnsr_FetchPulseOnAverage	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Average power of the ON portion of the pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchPulsePeak()

EXPORT int PwrSnsr_FetchPulsePeak	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the peak amplitude during the pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchRiseTime()

EXPORT int PwrSnsr_FetchRiseTime	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the interval between the first signal crossing of the proximal line to the first signal crossing of the distal line.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_FetchTimeArray()

EXPORT int PwrSnsr_FetchTimeArray	(	SessionID	Vi,
		const char *	Channel,
		float *	Frequency,
		PwrSnsrCondCodeEnum *	FrequencyValid,
		float *	Period,
		PwrSnsrCondCodeEnum *	PeriodValid,
		float *	Width,
		PwrSnsrCondCodeEnum *	WidthValid,
		float *	Offtime,
		PwrSnsrCondCodeEnum *	OfftimeValid,
		float *	DutyCycle,
		PwrSnsrCondCodeEnum *	DutyCycleValid,
		float *	Risetime,
		PwrSnsrCondCodeEnum *	RisetimeValid,
		float *	Falltime,
		PwrSnsrCondCodeEnum *	FalltimeValid,
		float *	EdgeDelay,
		PwrSnsrCondCodeEnum *	EdgeDelayValid,
		float *	Skew,
		PwrSnsrCondCodeEnum *	SkewValid
	)

Returns an array of the current automatic timing measurements performed on a periodic pulse waveform.

Measurements performed are: the frequency, period, width, offtime and duty cycle of the pulse waveform, and the risetime and falltime of the edge transitions. For each of the measurements to be performed, the appropriate items to be measured must within the trace window. Pulse frequency, period, offtime and duty cycle measurements require that an entire cycle of the pulse waveform (minimum of three edge transitions) be present. Pulse width measurement requires that at least one full pulse is visible, and is most accurate if the pulse width is at least 0.4 divisions. Risetime and falltime measurements require that the edge being measured is visible, and will be most accurate if the transition takes at least 0.1 divisions. It is always best to have the power meter set on the fastest timebase possible that meets the edge visibility restrictions. Set the trace averaging as high as practical to reduce fluctuations and noise in the pulse timing measurements. Note that the timing of the edge transitions is defined by the settings of the SENSe:PULSe:DISTal, :MESIal and :PROXimal settings; see the descriptions Forthose commands. Units are the same as the channel's units.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
Frequency	The number of cycles of a repetitive signal that take place in one second (Pulse Repetition Frequency).
FrequencyValid	Condition code.
Period	The interval between two successive pulses.
PeriodValid	Condition code.
Width	The interval between the first and second signal crossings of the mesial line.
WidthValid	Condition code.
Offtime	The time a repetitive pulse is off. (Equal to the pulse period minus the pulse width).
OfftimeValid	Condition code.
DutyCycle	The ratio of the pulse on-time to period.
DutyCycleValid	Condition code.
Risetime	The interval between the first signal crossing of the proximal line to the first signal crossing of the distal line.
RisetimeValid	Condition code.
Falltime	The interval between the last signal crossing of the distal line to the last signal crossing of the proximal line.
FalltimeValid	Condition code.
EdgeDelay	Time offset from the trigger reference to the first mesial transition level of either slope on the waveform.
EdgeDelayValid	Condition code.
Skew	The trigger offset between the assigned trigger channel and this channel.
SkewValid	Condition code.

Returns

Success (0) or error code.

PwrSnsr_FetchWaveform()

EXPORT int PwrSnsr_FetchWaveform	(	SessionID	Vi,
		const char *	Channel,
		int	WaveformArrayBufferSize,
		float	WaveformArray[],
		int *	WaveformArrayActualSize
	)

Returns a previously acquired waveform for this channel. The acquisition must be made prior to calling this method. Call this method separately for each channel.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
WaveformArrayBufferSize	Size in bytes of the Waveform buffer.
WaveformArray	The array contains the average waveform. Units for the individual array elements are in the channel units setting.
WaveformArrayActualSize	Size in bytes of the data written to WaveformArray.

Returns

Success (0) or error code.

PwrSnsr_FetchWaveformMinMax()

EXPORT int PwrSnsr_FetchWaveformMinMax	(	SessionID	Vi,
		const char *	Channel,
		int	MinWaveformBufferSize,
		float	MinWaveform[],
		int *	MinWaveformActualSize,
		int	MaxWaveformBufferSize,
		float	MaxWaveform[],
		int *	MaxWaveformActualSize,
		int	WaveformArrayBufferSize,
		float	WaveformArray[],
		int *	WaveformArrayActualSize
	)

Returns the previously acquired minimum and maximum waveforms for this specified channel. The acquisition must be made prior to calling this method. Call this method separately for each channel.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
MinWaveformBufferSize	Size in bytes of the MinWaveform buffer.
MinWaveform	This array contains the min waveform. Units for the individual array elements are in the channel units setting.
MinWaveformActualSize	Size in bytes of the data written to MinWaveform.
MaxWaveformBufferSize	Size in bytes of the MaxWaveform buffer.
MaxWaveform	This array contains the max waveform. Units for the individual array elements are in the channel units setting.
MaxWaveformActualSize	Size in bytes of the data written to MaxWaveform.
WaveformArrayBufferSize	Size in bytes of the Waveform buffer.
WaveformArray	The array contains the average waveform. Units for the individual array elements are in the channel units setting.
WaveformArrayActualSize	Size in bytes of the data written to WaveformArray.

Returns

Success (0) or error code.

PwrSnsr_FetchWidth()

EXPORT int PwrSnsr_FetchWidth	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Returns the pulse width, i.e. the interval between the first and second signal crossings of the mesial line.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement return value.

Returns

Success (0) or error code.

PwrSnsr_MeasurePower()

EXPORT int PwrSnsr_MeasurePower	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Return average power using a default instrument configuration in Modulated Mode and dBm units. Instrument remains stopped in Modulated Mode after a measurement.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement.
Val	Average power in dBm

Returns

Success (0) or error code.

PwrSnsr_MeasureVoltage()

EXPORT int PwrSnsr_MeasureVoltage	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Return average voltage using a default instrument configuration in Modulated Mode and volts units. Instrument remains stopped in Modulated Mode after a measurement.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement.
Val	Average voltage in linear volts.

Returns

Success (0) or error code.

PwrSnsr_ReadCWArray()

EXPORT int PwrSnsr_ReadCWArray	(	SessionID	Vi,
		const char *	Channel,
		float *	PeakAverage,
		PwrSnsrCondCodeEnum *	PeakAverageValid,
		float *	PeakMax,
		PwrSnsrCondCodeEnum *	PeakMaxValid,
		float *	PeakMin,
		PwrSnsrCondCodeEnum *	PeakMinValid,
		float *	PeakToAvgRatio,
		PwrSnsrCondCodeEnum *	PeakToAvgRatioValid
	)

Returns the current average, maximum, minimum powers or voltages and the peak-to-average ratio of the specified channel. Units are the same as the channel's units. Note the peak-to-average ratio and marker ratio are returned in dB for logarithmic channel units, and percent for all other channel units.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
PeakAverage	Average power of the peak power envelope.
PeakAverageValid	Condition code.
PeakMax	Maximum power of the peak power envelope.
PeakMaxValid	Condition code.
PeakMin	Minimum power of the peak power envelope.
PeakMinValid	Condition code.
PeakToAvgRatio	Peak to average ratio.
PeakToAvgRatioValid	Condition code.

Returns

Success (0) or error code.

PwrSnsr_ReadCWPower()

EXPORT int PwrSnsr_ReadCWPower	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	IsValid,
		float *	Val
	)

Initiates a CW power acquisition and returns the result in channel units.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
IsValid	Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadDutyCycle()

EXPORT int PwrSnsr_ReadDutyCycle	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the ratio of the pulse on-time to off-time.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadEdgeDelay()

EXPORT int PwrSnsr_ReadEdgeDelay	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns time offset from the trigger reference to the first mesial transition level of either slope on the waveform.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadFallTime()

EXPORT int PwrSnsr_ReadFallTime	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the interval between the last signal crossing of the distal line to the last signal crossing of the proximal line.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadIEEEBottom()

EXPORT int PwrSnsr_ReadIEEEBottom	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the IEEE-define base line, i.e. The two portions of a pulse waveform which represent the first nominal state from which a pulse departs and to which it ultimately returns.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadIEEETop()

EXPORT int PwrSnsr_ReadIEEETop	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the IEEE-defined top line, i.e. the portion of a pulse waveform which represents the second nominal state of a pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadOfftime()

EXPORT int PwrSnsr_ReadOfftime	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the time a repetitive pulse is off. (Equal to the pulse period minus the pulse width).

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadOvershoot()

EXPORT int PwrSnsr_ReadOvershoot	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the difference between the distortion following a major transition and the IEEE top line in dB or percent, depending on the channel units.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadPeriod()

EXPORT int PwrSnsr_ReadPeriod	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the interval between two successive pulses.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadPowerArray()

EXPORT int PwrSnsr_ReadPowerArray	(	SessionID	Vi,
		const char *	Channel,
		float *	PulsePeak,
		PwrSnsrCondCodeEnum *	PulsePeakValid,
		float *	PulseCycleAvg,
		PwrSnsrCondCodeEnum *	PulseCycleAvgValid,
		float *	PulseOnAvg,
		PwrSnsrCondCodeEnum *	PulseOnValid,
		float *	IEEETop,
		PwrSnsrCondCodeEnum *	IEEETopValid,
		float *	IEEEBottom,
		PwrSnsrCondCodeEnum *	IEEEBottomValid,
		float *	Overshoot,
		PwrSnsrCondCodeEnum *	OvershootValid,
		float *	Droop,
		PwrSnsrCondCodeEnum *	DroopValid
	)

Returns an array of the current automatic amplitude measurements performed on a periodic pulse waveform.

Measurements performed are: peak amplitude during the pulse, average amplitude over a full cycle of the
pulse waveform, average amplitude during the pulse, IEEE top amplitude, IEEE bottom amplitude, and overshoot.
Units are the same as the channel's units. Note the pulse overshoot is returned in dB for logarithmic channel units,
and percent for all other units. Also, the pulse ON interval used for peak and average calculations is
defined by the SENSe:PULSe:STARTGT and :ENDGT time gating settings.
A full pulse (rise and fall) must be visible on the display to make average and peak pulse power measurements,
and a full cycle of the waveform must be visible to calculate average cycle amplitude.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
PulsePeak	The peak amplitude during the pulse.
PulsePeakValid	Condition code.
PulseCycleAvg	Average cycle amplitude.
PulseCycleAvgValid	Condition code.
PulseOnAvg	Average power of the ON portion of the pulse.
PulseOnValid	Condition code.
IEEETop	The IEEE-defined top line, i.e. the portion of a pulse waveform, which represents the second nominal state of a pulse.
IEEETopValid	Condition code.
IEEEBottom	The IEEE-define base line, i.e. The two portions of a pulse waveform which represent the first nominal state from which a pulse departs and to which it ultimately returns.
IEEEBottomValid	Condition code.
Overshoot	The difference between the distortion following a major transition and the IEEE top line in dB or percent,depending on the channel units.
OvershootValid	Condition code.
Droop	Pulse droop.
DroopValid	Condition code.

Returns

Success (0) or error code.

PwrSnsr_ReadPRF()

EXPORT int PwrSnsr_ReadPRF	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the number of cycles of a repetitive signal that take place in one second (Pulse Repetition Frequency).

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadPulseCycleAvg()

EXPORT int PwrSnsr_ReadPulseCycleAvg	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the average power of the entire pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadPulseOnAverage()

EXPORT int PwrSnsr_ReadPulseOnAverage	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Average power of the ON portion of the pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadPulsePeak()

EXPORT int PwrSnsr_ReadPulsePeak	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the peak amplitude during the pulse.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadRiseTime()

EXPORT int PwrSnsr_ReadRiseTime	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the interval between the first signal crossing of the proximal line to the first signal crossing of the distal line.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.

PwrSnsr_ReadTimeArray()

EXPORT int PwrSnsr_ReadTimeArray	(	SessionID	Vi,
		const char *	Channel,
		float *	Frequency,
		PwrSnsrCondCodeEnum *	FrequencyValid,
		float *	Period,
		PwrSnsrCondCodeEnum *	PeriodValid,
		float *	Width,
		PwrSnsrCondCodeEnum *	WidthValid,
		float *	Offtime,
		PwrSnsrCondCodeEnum *	OfftimeValid,
		float *	DutyCycle,
		PwrSnsrCondCodeEnum *	DutyCycleValid,
		float *	Risetime,
		PwrSnsrCondCodeEnum *	RisetimeValid,
		float *	Falltime,
		PwrSnsrCondCodeEnum *	FalltimeValid,
		float *	EdgeDelay,
		PwrSnsrCondCodeEnum *	EdgeDelayValid,
		float *	Skew,
		PwrSnsrCondCodeEnum *	SkewValid
	)

Returns an array of the current automatic timing measurements performed on a periodic pulse waveform.

Measurements performed are: the frequency, period, width, offtime and duty cycle of the pulse waveform, and the risetime and falltime of the edge transitions. For each of the measurements to be performed, the appropriate items to be measured must within the trace window. Pulse frequency, period, offtime and duty cycle measurements require that an entire cycle of the pulse waveform (minimum of three edge transitions) be present. Pulse width measurement requires that at least one full pulse is visible, and is most accurate if the pulse width is at least 0.4 divisions. Risetime and falltime measurements require that the edge being measured is visible, and will be most accurate if the transition takes at least 0.1 divisions. It is always best to have the power meter set on the fastest timebase possible that meets the edge visibility restrictions. Set the trace averaging as high as practical to reduce fluctuations and noise in the pulse timing measurements. Note that the timing of the edge transitions is defined by the settings of the SENSe:PULSe:DISTal, :MESIal and :PROXimal settings; see the descriptions For those commands. Units are the same as the channel's units.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
Frequency	The number of cycles of a repetitive signal that take place in one second (Pulse Repetition Frequency).
FrequencyValid	Condition code.
Period	The interval between two successive pulses.
PeriodValid	Condition code.
Width	The interval between the first and second signal crossings of the mesial line.
WidthValid	Condition code.
Offtime	The time a repetitive pulse is off. (Equal to the pulse period minus the pulse width).
OfftimeValid	Condition code.
DutyCycle	The ratio of the pulse on-time to period.
DutyCycleValid	Condition code.
Risetime	The interval between the first signal crossing of the proximal line to the first signal crossing of the distal line.
RisetimeValid	Condition code.
Falltime	The interval between the last signal crossing of the distal line to the last signal crossing of the proximal line.
FalltimeValid	Condition code.
EdgeDelay	Time offset from the trigger reference to the first mesial transition level of either slope on the waveform.
EdgeDelayValid	Condition code.
Skew	The trigger offset between the assigned trigger channel and this channel.
SkewValid	Condition code.

Returns

Success (0) or error code.

PwrSnsr_ReadWaveform()

EXPORT int PwrSnsr_ReadWaveform	(	SessionID	Vi,
		const char *	Channel,
		int	WaveformArrayBufferSize,
		float	WaveformArray[],
		int *	WaveformArrayActualSize
	)

Initiates an acquisition on all enabled channels, waits (up to MaxTime) for the acquisition to complete, and returns the waveform for this channel. Call FetchWaveform to obtain the waveforms for other channels.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
WaveformArrayBufferSize	Size in bytes of the Waveform buffer.
WaveformArray	The array contains the average waveform. Units for the individual array elements are in the channel units setting.
WaveformArrayActualSize	Size in bytes of the data written to WaveformArray.

Returns

Success (0) or error code.

PwrSnsr_ReadWaveformMinMax()

EXPORT int PwrSnsr_ReadWaveformMinMax	(	SessionID	Vi,
		const char *	Channel,
		int	MinWaveformBufferSize,
		float	MinWaveform[],
		int *	MinWaveformActualSize,
		int	MaxWaveformBufferSize,
		float	MaxWaveform[],
		int *	MaxWaveformActualSize,
		int	WaveformArrayBufferSize,
		float	WaveformArray[],
		int *	WaveformArrayActualSize
	)

Initiates an acquisition on all enabled channels, waits (up to MaxTime) for the acquisition to complete, and returns the min/max waveforms for this channel. Call FetchMinMaxWaveform to obtain the min/max waveforms for other channels.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
MinWaveformBufferSize	Size in bytes of the MinWaveform buffer.
MinWaveform	This array contains the min waveform. Units for the individual array elements are in the channel units setting.
MinWaveformActualSize	Size in bytes of the data written to MinWaveform.
MaxWaveformBufferSize	Size in bytes of the MaxWaveform buffer.
MaxWaveform	This array contains the max waveform. Units for the individual array elements are in the channel units setting.
MaxWaveformActualSize	Size in bytes of the data written to MaxWaveform.
WaveformArrayBufferSize	Size in bytes of the Waveform buffer.
WaveformArray	The array contains the average waveform. Units for the individual array elements are in the channel units setting.
WaveformArrayActualSize	Size in bytes of the data written to WaveformArray.

Returns

Success (0) or error code.

PwrSnsr_ReadWidth()

EXPORT int PwrSnsr_ReadWidth	(	SessionID	Vi,
		const char *	Channel,
		PwrSnsrCondCodeEnum *	CondCode,
		float *	Val
	)

Returns the pulse width, i.e. the interval between the first and second signal crossings of the mesial line.

Parameters

Vi	The SessionID handle that you obtain from the PwrSnsr_init function. The handle identifies a particular instrument session.
Channel	Channel number. For single instruments, set this to "CH1".
CondCode	Condition code for the measurement. Condition code.
Val	Measurement value.

Returns

Success (0) or error code.