bpm_get_plot_window_info_c

	status.i4.v = bpm_get_plot_window_info_c(screen.i4.v, data_type.i4.v,
						 plane.i4.v, options.u4.v,
						 num_windows.i4.r,
						 window_info.sp.r)

	This routine retrieves information about existing BPM plot windows
	created by calls to bpm_plot_data.  The returned plot information
	must be freed by the caller.

	screen		graphics screen to interrogate
			(BPM_PLT_SCR_G1 -> GxP1,
			 BPM_PLT_SCR_G2 -> GxP2,
			 CLIB_DEFAULT_ARG -> last screen plotted on)
	data_type	type of plot windows to retrieve information for
			(BPM_DATA_TYPE_BPM -> BPM data windows,
			 BPM_DATA_TYPE_BLM -> BLM data windows,
			 BPM_DATA_TYPE_INTENSITY -> intensity data windows,
			 CLIB_DEFAULT_ARG -> all data windows)
	plane		data plane
			(BPM_HORZ -> horizontal plane,
			 BPM_VERT -> vertical plane,
			 CLIB_DEFAULT_ARG -> both planes)
	options		retrieval options (not used)
	num_windows	returned number of windows
	window_info	returned plot window information
			(structures of type BPM_PLOT_WINDOW_DATA)
			(Note: This memory must be freed by the caller.)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid screen, plot type, or plane requested
	CBS_NOINIT		no BPM plots are present
	CBS_DUPREQ		updating is already enabled

	This function requires the following include files:

	ul_cbsaux/bpmuti.h, acnet_errors_h

	Related functions:

	bpm_plot_data, bpm_interrogate_plot

	C/C++ usage:

	int	status;
	int	screen = CLIB_DEFAULT_ARG;
	int	data_type = CLIB_DEFAULT_ARG;
	int	plane = CLIB_DEFAULT_ARG;
	int	num_windows;
	unsigned int	options = 0;
	BPM_PLOT_WINDOW_DATA	*window_info;
	
	status = bpm_get_plot_window_info_c(screen,data_type,plane,options,
					    &num_windows,&window_info);