Processpdl; Getpdltrace - JDS Uniphase SWS15100 User Manual

Function Description
Return Value If there is no error and another IL data value has been acquired, but PDL
acquisition is not yet finished, the return value is 0.
If there is no error and all four IL sets of data (for all four polarization states)
have been properly acquired, the return value is 1.
If there is an error, the return value contains the error number.

processPDL

Function Description
Purpose The processPDL function is used to calculate the PDL for all the channels in
the user list. The user acquires the IL data for all channels in the channel list
through calls to the acquirePDL function. If one of the four sets of required IL
data (S1, S2, S3, or S4) or one channel data value is missing, the function
returns an error.
C prototype int processPDL( unsigned short *chList, unsigned short uhNumChannels)
VB prototype Declare Function processPDL Lib "SWS15100" (ByRef chList%, ByVal
numChannels) As Long
Input unsigned short *chList:
This is the list of channels selected for acquiring all four references.
unsigned short uhNumChannels:
This is the number of channels in the list.
Output None
Return Value If there is no error, the return value is 0.
If there is an error, the return value contains the error number.

getPDLTrace

Function Description
Purpose The getPDLTrace function is used to get the PDL traces for a specific
channel. This function is called after a call to the processPDL function.
C prototype int getPDLTrace(unsigned short chID, double *dLam, double *dPowMin,
double *dPowMax, double *dPowAve, double *dPowPdl,
unsigned short *uhDataSize)
VB prototype Declare Function getPDLTrace Lib "SWS15100" (ByVal chID%, ByRef dLam
As Double, ByRef powMin As Double, ByRef powMax As Double, ByRef
powAve As Double, ByRef powPdl As Double, ByRef dataSize%) As Long
Input unsigned short chID:
This is the channel number.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com
Programming Guide – 143