以下はアナライザーからデータを取得する機能です。
IsRunning ( int *runStatus )
アンライザーをリアルタイムモードもしくはレコーディングモードでランします
Parameters: runStatus
= pointer to receive the analyzer run status (0 = stopped, 1 = running or
recording)
Return: S_OK = success, E_FAIL
GetCurrentFileTime( long channel, float *seconds )
指定したチャンネルのファイルの現在位置を求めます
Parameters: channel = 0 - 15; seconds =
pointer to variable to receive the time value in seconds
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTotalFileTime( long channel, float *seconds )
指定したチャンネルのファイルのファイル長(時間)を求めます
Parameters: channel = 0 - 15; seconds =
pointer to variable to receive the time value in seconds
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetCurrentFileSample( long channel, unsigned long *sample )
指定したチャンネルのファイルのサンプルポジションを求めます
Parameters: channel = 0 - 15; sample
=pointer to variable to receive the sample position
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTotalFileSamples( long channel, unsigned long *samples )
指定したチャンネルのファイルの総サンプル数を求めます
Parameters: channel = 0 - 15; samples =
pointer to variable to receive the total samples value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetFFTCount( long channel, long *fftcount
)
ランかレコードが最後にスタートしてから実行されたFFTの回数を求めます
Parameters: channel = 0 - 15; fftcount - pointer to variable to receive the the fft count
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetOverloadCount( long channel, long *overloadcount
)
ランかレコードが最後にスタートしてから検出されたオーバーロード(クリップ)の回数を求めます
Parameters: channel = 0 - 15; overloadcount - pointer to variable to receive the the overload count
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
GetPeakFrequency( long channel_ext,
float *freq )
指定したチャンネルの全スパン中のピーク周波数を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; freq = pointer
to variable to receive the peak frequency
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPeakFrequencyNth( long channel_ext,
long peak_number, float *freq )
指定したチャンネルの全スパン中のN次ピーク周波数を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; peak_number = 0 - 10; freq = pointer to variable to receive
the peak frequency
Return: S_OK = success, E_FAIL = unsuccessful,
E_INVALIDARG = invalid parameter
GetPeakFrequencyNthSpan( long channel_ext,
long peak_number, float startHz,
float stopHz, float *freq )
指定したチャンネルの指定スパン中のN次ピーク周波数を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; peak_number = 0 - 10; startHz =
span start frequency; stopHz = span stop frequency; freq
= pointer to variable to receive the peak frequency
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPeakAmplitude( long channel_ext,
float *amplitude )
指定したチャンネルの全スパン中のピークアンプリチュードを求めます
Description: Get the peak amplitude in the
total span for the specified channel
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; amplitude =
pointer to variable to receive the peak amplitude
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPeakAmplitudeNth( long channel_ext,
long peak_number, float *amplitude )
指定したチャンネルの全スパン中のN次ピークアンプリチュードを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; peak amplitude
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPeakAmplitudeNthSpan( long channel_ext,
long peak_number, float startHz,
float stopHz, float *amplitude )
指定したチャンネルの指定スパン中のN次ピークアンプリチュードを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels; peak_number = 0 - 10; startHz =
span start frequency; stopHz = span stop frequency; amplitude
= pointer to variable to receive the peak amplitude
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTotalPower( long channel_ext,
long weighting, float *power )
Description: Get the total power in the
total span for the specified channel and weighting
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
weighting: 0 = Flat, 1 = A, 2 = B, 3 = C
power = pointer to variable to receive the
total power value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTotalPowerSpan( long channel_ext,
long weighting, float startHz, float stopHz, float *power )
指定したチャンネルの指定周波数スパン中のトータルパワーを求めます。ウェイティングの指定も可能です
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
weighting:
0 = Flat, 1 = A, 2 = B, 3 = C
startHz = span start frequency; stopHz
= span stop frequency;
power
= pointer to variable to receive the total power
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTHD( long channel_ext,
float *thd )
指定したチャンネルの全スパンのTHDを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
thd = pointer to variable to receive the THD value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTHDSpan( long channel_ext,
float startHz, float stopHz,
float *thd )
指定したチャンネルと周波数スパンのTHDを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
startHz = span start frequency; stopHz
= span stop frequency;
thd = pointer to variable to receive the THD value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTHD_N( long channel_ext,
float *thd_n )
指定したチャンネルの全スパンのTHD+Nを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
thd_n = pointer to variable to receive the THD+N value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTHD_NSpan( long channel_ext,
float startHz, float stopHz,
float *thd_n )
指定したチャンネルと周波数スパンのTHD+Nを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
startHz = span start frequency; stopHz
= span stop frequency;
thd_n = pointer to variable to receive the THD+N value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetIMD( long channel_ext,
float *imd )
指定したチャンネルの全スパンのIMDを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
imd = pointer to variable to receive the IMD value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSNR( long channel_ext,
float *snr )
指定したチャンネルの全スパンのSNRを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
snr = pointer to variable to receive the SNR value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSNRSpan( long channel_ext,
float startHz, float stopHz,
float *snr )
指定したチャンネルと周波数スパンのSNRを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
startHz = span start frequency; stopHz
= span stop frequency;
snr = pointer to variable to receive the SNR value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSINAD( long channel_ext,
float *sinad )
指定したチャンネルの全スパンのSINADを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
sinad = pointer to variable to receive the SINAD value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSINADSpan( long channel_ext,
float startHz, float stopHz,
float *sinad )
指定したチャンネルと周波数スパンのSINADを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
startHz = span start frequency; stopHz
= span stop frequency;
sinad = pointer to variable to receive the SINAD value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetMarkerFrequency( long channel_ext,
long marker, float *freq )
指定したマーカの周波数を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
marker
= 1 - 8;
freq
= pointer to variable to receive the frequency value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetMarkerAmplitude( long channel_ext,
long marker, float *amplitude )
指定したマーカのアンプリチュードを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
marker
= 1 - 8;
amplitude
= pointer to variable to receive the amplitude value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
Conversion Operations(変換操作)
ConvertTimeToSample( long channel, float time_seconds,
unsigned long *sample )
指定したチャンネルの秒をサンプルポジションに変換します
Parameters: channel_ext
= 0 - 15; time_seconds = time value to convert
sample
= pointer to variable to receive the sample position
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
ConvertSampleToTime( long channel, unsigned long sample, float
*time_seconds )
指定したチャンネルのサンプルポジションを秒に変換します
Parameters: channel_ext
= 0 - 15; sample = sample position to convert
time_seconds = pointer to variable to receive the time in
seconds
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTimeSeriesValueFromTime( long channel, float time_seconds,
float *value )
指定した時間のタイムシリーズアンプリチュードを求めます
Parameters: channel_ext
= 0 - 15; time_seconds = file position time in
seconds
value
= pointer to variable to receive the time series amplitude value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTimeSeriesValueFromSample( long channel, unsigned long sample, float
*value )
指定したサンプルポジションのタイムシリーズ値を求めます
Parameters: channel_ext
= 0 - 15; sample = file position in samples
value
= pointer to variable to receive the time series amplitude value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetMaxTimeSeriesValueInSegment( long channel, unsigned long startSample, unsigned long stopSample,
float *value )
指定した時間レンジの最大タイムシリーズ値を求めます
Parameters: channel_ext
= 0 - 15;
startSample = time segment start position in samples;
stopSample = time segment stop position in samples;
value = pointer to variable to receive the maximum time series amplitude value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetMinTimeSeriesValueInSegment( long channel, unsigned long startSample, unsigned long stopSample,
float *value )
指定した時間レンジの最小タイムシリーズ値を求めます
Parameters: channel_ext
= 0 - 15;
startSample = time segment start position in samples;
stopSample = time segment stop position in samples;
value
= pointer to variable to receive the minimum time series amplitude value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTimeSeriesFromFile( long channel, SAFEARRAY __RPC_FAR *
__RPC_FAR *psaTimes, SAFEARRAY __RPC_FAR * __RPC_FAR
*psaData )
指定したチャンネルのタイムシリーズデータ列を求めます
Parameters: channel_ext
= 0 - 15;
psaTimes = pointer to array of time values
psaData = pointer to array of amplitude values
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTimeSeriesFromFileSegmentSample( long channel, unsigned long startSample, unsigned long stopSample,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaTimes, SAFEARRAY
__RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルとサンプルレンジのタイムシリーズデータ列を求めます
Parameters: channel_ext
= 0 - 15;
startSample = start sample of time series segment;
stopSample = stop sample of time series segment;
psTimes = pointer to array of time values
psaData = pointer to array of amplitude values
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetTimeSeriesFromFileSegmentTime( long channel, float startSecs, float stopSecs,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaTimes, SAFEARRAY
__RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルと時間レンジのタイムシリーズデータ列を求めます
Parameters: channel_ext
= 0 - 15;
startSecs = start time of time series segment;
stopSecs = stop time of time series segment;
psaTimes = pointer to array of time values
psaData = pointer to array of amplitude values
Return: S_OK = success, E_FAIL = unsuccessful,
E_INVALIDARG = invalid parameter
GetSpectrumMinFrequency( long channel_ext,
float *freq )
指定したチャンネルのスペクトラルデータの最小周波数を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
freq
= pointer to variable to receive the frequency value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSpectrumMaxFrequency( long channel_ext,
float *freq )
指定したチャンネルのスペクトラルデータの最大周波数を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
freq
= pointer to variable to receive the frequency value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSpectrumValue( long channel_ext,
float freqHz, float *value )
指定したチャンネルと周波数の、スペクトラルデータのアンプリチュードを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
freqHz = frequency to read the amplitude
value
= pointer to variable to receive the amplitude value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSpectrum( long channel_ext,SAFEARRAY
__RPC_FAR * __RPC_FAR *psaFrequencies, SAFEARRAY
__RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルのスペクトラルデータ列を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
psaFrequencies = pointer to array of frequency values
psaData = pointer to array of amplitude values
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetSpectrumInSpan( long channel_ext,
float startHz, float stopHz,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaFrequencies,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルと周波数レンジのスペクトラルデータ列を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
startHz = start frequency of selected span;
stopHz = stop frequency of selected span;
psaFrequencies = pointer to array of frequency values
psaData = pointer to array of amplitude values
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPeakHoldSpectrumValue( long channel_ext,
float freqHz, float *value )
指定したチャンネルと周波数の、スペクトラルデータのピークアンプリチュードを求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
freqHz = frequency to read the amplitude
value
= pointer to variable to receive the amplitude value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPeakHoldSpectrum( long channel_ext,SAFEARRAY
__RPC_FAR * __RPC_FAR *psaFrequencies, SAFEARRAY
__RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルのピークホールドスペクトラルデータ列を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
psaFrequencies = pointer to array of frequency values
psaData = pointer to array of amplitude values
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPeakHoldSpectrumInSpan( long channel_ext,
float startHz, float stopHz,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaFrequencies,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルと周波数レンジのピークホールドスペクトラルデータ列を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
startHz = start frequency of selected span;
stopHz = stop frequency of selected span;
psaFrequencies = pointer to array of frequency values
psaData = pointer to array of amplitude values
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
GetComplexSpectrum( long channel_ext,SAFEARRAY __RPC_FAR *
__RPC_FAR *psaFrequencies, SAFEARRAY __RPC_FAR * __RPC_FAR
*psaDataR,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaDataI )
指定されたチャンネルのcomplexスペクトルデータの配列を取得します
Parameters: channel_ext: 0 = Left, 1 = Right, 2 = Composite, 3 = Coherence.
psaFrequencies = pointer to array of frequency values
psaDataR = pointer to array of real component of complex values
psaDataI = pointer to array of imaginary component of complex values
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
Note: コンポジットチャネル=デュアルチャネル動作(L&R平均、トランスファーまたはクロススペクトル)
GetComplexSpectrumInSpan( long channel_ext, float startHz, float
stopHz, SAFEARRAY __RPC_FAR * __RPC_FAR
*psaFrequencies,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaDataR,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaDataI)
指定されたチャンネルのcomplexスペクトルデータの配列を取得します
Parameters: channel_ext: 0 = Left, 1 = Right, 2 = Composite, 3 = Coherence.
startHz = start frequency of selected span;
stopHz = stop frequency of selected span;
psaFrequencies = pointer to array of frequency values
psaDataR = pointer to array of real component of complex values
psaDataI = pointer to array of imaginary component of complex values
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
Note: コンポジットチャネル=デュアルチャネル動作(L&R平均、トランスファーまたはクロススペクトル)
GetPhaseValue( long channel_ext,
float freqHz, float *value )
指定したチャンネルと周波数の位相を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
freqHz = frequency to read the phase
value
= pointer to variable to receive the phase value
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPhase( long channel_ext,SAFEARRAY
__RPC_FAR * __RPC_FAR *psaFrequencies, SAFEARRAY
__RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルの位相データ列を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
psaFrequencies = pointer to array of frequency values
psaData = pointer to array of phase values
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetPhaseInSpan( long channel_ext,
float startHz, float stopHz,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaFrequencies,
SAFEARRAY __RPC_FAR * __RPC_FAR *psaData )
指定したチャンネルと周波数レンジの位相データ列を求めます
Parameters: channel_ext
= 0 - 15 for main channels, 16 - 31 for composite channels;
startHz = start frequency of selected span;
stopHz = stop frequency of selected span;
psaFrequencies = pointer to array of frequency values
psaData = pointer to array of phase values
Return: S_OK = success, E_FAIL =
unsuccessful, E_INVALIDARG = invalid parameter
GetLeqValues( long channel, float *LeqT,
float *Leq, float *Lsel,
float *Lpk, float *Lmax, float
*Lmin, float *L10, float* L50, float *L90 )
指定したチャンネルのLeq (Equivalent Noise Level)を求めます
Parameters: channel_ext
= 0 - 15
LeqT = pointer to the equivalent noise level
converted to the user specified "reference time period".
Leq = pointer to the equivalent noise level
for the selected time segment.
Lsel = pointer to the equivalent noise level
converted to a 1 second period.
Lpk = pointer to the peak level for the
selected time segment. No averaging is used for this parameter.
Lmax = pointer to the maximum level for the
selected data.
Lmin = pointer to the minimum level for the
selected data.
L10 = pointer to the level exceeded 10% of
the time.
L50 = pointer to the level exceeded 50% of
the time.
L90 = pointer to the level exceeded 90% of
the time.
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
Misc
GetDelayFinderValue( float *value )
Delay Finder ユーティリティの現在の値を取得します (ユーティリティは開いている必要があります)
Parameters: value = pointer to the delay value
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter
GetMetadata( BSTR* metadata )
現在の wafe ファイルからメタデータテキストを取得します。この関数を実行するには、WAVEファイルを開いていなければなりません
Parameters: metadata - up to 2000 characters max of ascii text
Return: S_OK = success, E_FAIL = unsuccessful, E_INVALIDARG = invalid parameter