CIGI API Version 2.7.1

CIGI API : Users' Guide



		Index


		Overview
		Design Objectives
		Platform Issues
		Compiler Issues
		Preprocessor Definitions
		Implementation Notes
		Versioning
		File Listing
		API Usage
		Sessions
		Messages
		Sequence and Timing
		Processing Incoming Data
		Working with Packets
		Examples
		Simple Host and IG
		Win32 IG
		Win32 Host
		References
		CIGI Error Codes
		CIGI Constants
		Compilation Flags
		Index of Changes
		Contributor List
		Current Release Files

		Examples : Win32 IG

Examples

Windows GUI Image Generator Example

The DummyIG application is an example of a CIGI compliant image generator on the Windows (Win32) platform. The example displays the incoming packets to a console window. The following window is used to filter the packets that are printed to the console window.

Figure - IG Packet Filter Window

In addition, the DummyIG example shows the use of CIGI callback messages to process incoming packets. This sample is useful for debugging a CIGI host implementation.

Running the Example

To run the DummyIG sample application from a command line, the following arguments are expceted.

DummyIG <ip address> <send port> <receive port>

Where the arguments are as follows:

ip address: The IP address of a CIGI host to connect to.
send port: The port number to use for sending packets to the CIGI host.
receive port: The port number to use for receiving pacekts from the CIGI host.

File Listing : DummyIG Example

The following listing shows the files from the DummyIG example, including the Visual C++ 6.0 project and workspace files for Windows development.

cigi	CIGI home folder.
api	CIGI API source files.
cigi_api.h	Core API header.
cigi_api.c	Core API implementation.
cigi_helper.h	CIGI API utility header.
cigi_helper.c	CIGI API utility implementation.
cigi_icd.h	The CIGI interface header.
samples	CIGI sample applications.
DummyIG	Windows/GUI sample of an IG implementation.
DummyIG.dep	Visual C++ 6.0 dependency file (Win32).
DummyIG.dsp	Visual C++ 6.0 project file (Win32).
DummyIG.dsw	Visual C++ 6.0 workspace file (Win32).
DummyIG.mak	Visual C++ 6.0 make file (Win32).
DummyIG.h	Implementation of the DummyIG application.
DimmyIG.cpp	Header file for the DummyIG application.
DummyIG.rc	Visual C++ 6.0 resource file.
FilterDialog.h	Main dialog window header file.
FilterDialog.cpp	Main dialog window implementation.
resource.h	Header file containing resouce definitions.
StdAfx.cpp	Visual C++ 6.0 MFC generated file.
StdAfx.h	Visual C++ 6.0 MFC generated file.

******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ******** ********