GBS Elektronik MCA-166 Communication DLL - Manual (Page 26)

MCA527
Name MMCA_QUERY_OSCI_SCREEN
Description The function reads the data for the oscilloscope screen.
Declaration
ERROR_FLAG CALLBACK MMCA_QUERY_OSCI_SCREEN(unsigned long ulPosition,
LPSTR rec_data);
ulPosition
-1 or the previously returned position.
rec_data
Pointer to a QUERY_OSCI_SCREEN structure. See CMD_QUERY_OSCI_SCREEN or mca_comm.h.
Return value See MCA_COMM function
Remarks This function is only usable for MCA527.
The oscilloscope mode is described in document: “MCA527 Oscilloscope Mode”.
Name MMCA_QUERY_OSCI_SCREEN_EX
Description The function reads the data for the oscilloscope screen.
Besides, it initiates the convolution of the data with the trigger filter and the main filter. The results can be
read afterwards with the functions MMCA_QUERY_OSCI_TRIGGER_FILTER_RESULTS and
MMCA_QUERY_OSCI_MAIN_FILTER_RESULTS.
Declaration
ERROR_FLAG CALLBACK MMCA_QUERY_OSCI_SCREEN_EX(unsigned short unFlags,
LPSTR rec_data);
unFlags
Bit 0: convolve data with trigger filter
Bit 1: convolve data with main filter
rec_data
Pointer to a QUERY_OSCI_SCREEN_EX structure. See CMD_QUERY_OSCI_SCREEN_EX or
mca_comm.h.
Return value See MCA_COMM function
Remarks This function is only usable for MCA527.
The oscilloscope mode is described in document: “MCA527 Oscilloscope Mode”.
Name MMCA_QUERY_OSCI_TRIGGER_FILTER_RESULTS
Description The function returns the results of the convolution of the oscilloscope data with the trigger filter. The
calculation is initiated by the function MMCA_QUERY_OSCI_SCREEN_EX.
Declaration
ERROR_FLAG CALLBACK MMCA_QUERY_OSCI_TRIGGER_FILTER_RESULTS(unsigned short unFlag,
LPSTR rec_data);
unFlag 0 = read 360 values, ≠0 = read 720 values.
rec_data
Pointer to a QUERY_OSCI_TRIGGER_FILTER_RESULTS structure.
See CMD_QUERY_OSCI_TRIGGER_FILTER_RESULTS or mca_comm.h.
Return value See MCA_COMM function
Remarks This function is only usable for MCA527.
Name MMCA_QUERY_OSCI_MAIN_FILTER_RESULTS
Description The function returns the results of the convolution of the oscilloscope data with the main filter. The
calculation is initiated by the function MMCA_QUERY_OSCI_SCREEN_EX.
Declaration
ERROR_FLAG CALLBACK MMCA_QUERY_OSCI_MAIN_FILTER_RESULTS(LPSTR rec_data);
rec_data
Pointer to a QUERY_OSCI_MAIN_FILTER_RESULTS structure.
See CMD_QUERY_OSCI_MAIN_FILTER_RESULTS or mca_comm.h.
Return value See MCA_COMM function
Remarks This function is only usable for MCA527.
26