Getpeakpower - JDS Uniphase SWS15100 User Manual

Function Description
Output double *pLamData:
The pLamData array stores wavelength for each data point in the trace. The
function updates the array and the pointer to the array is passed as input.
double *pPowData:
The pPowData array stores the IL power level (dB scale). Each value from
pPowData array has a corresponding wavelength value in the pLamData
array. The function updates the array and the pointer to the array must be
passed as input.
short *pola:
The function returns the polarization of the current processed trace.
Return Value When there is no error, the function returns zero.
When there is an error, the return value contains the error number.

getPeakPower

Function Description
Purpose The getPeakPower function retrieves the power of the largest peak that is
contained in the pPowData power array. Call the function after obtaining
pPowData data through a call to the getILTrace function. The refpeak
parameter must be filled by the caller.
C prototype int getPeakPower( double *pLamData, double *pPowData, unsigned short
dataSize, unsigned short refpeak, unsigned short *peakIndex, double
*pPowPeak, double *pLamPeak );
VB prototype Declare Function getPeakPower Lib "SWS15100" (ByRef pLamData As
Double, ByRef pPowData As Double, ByVal dataSize%, ByVal refPeak%,
ByRef PeakIndex%, ByRef pPowPeak As Double, ByRef pLamPeak As
Double) As Long
Input double *pLamData:
The pLamData array stores the wavelength for each data point in the trace.
double *pPowData:
The pPowData array stores the measured power levels (dB scale) for each
point in the trace. Each point from the pPowData array has a corresponding
point in the pLamData array.
unsigned short dataSize:
This is the size of arrays pLamData and pPowData allocated by the user. This
is the size of the acquired trace retrieved by the user using the function
getDataSize.
unsigned short refpeak:
This is an integer set of values:
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com
Programming Guide – 135