Connecting to a Transmission Source

The current version of the ATVEFSnd.dll component is primarily designed for transmitting enhancements over the VBI of an analog TV signal. The hardware device that actually inserts the data into the TV signal is called a VBI Inserter, and this is the device that the ATVEFSnd.dll component sends its data to over a TCP connection.

The ATVEFSnd.dll component also provides an interface which your application can use to transmit the enhancements over a NIC. This type of native multicasting is generally used only when testing enhancements over a LAN, where the listening hosts are on the same LAN segment as the transmitter.

If your application will be sending its data to a VBI Inserter, it must co-create a CSendATVEFInserter object and initialize it with IATVEFInserterConfig::Initialize or IATVEFInserterConfig::InitializeEx. If your application will use native multicasting, it should co-create a CSendATVEFMulticast object and initialize it with IATVEFMulticastConfig::Initialize.

Once your application has initialized itself for transmitting, and properly configured the announcement, it can connect to the transmission source by calling IATVEFSend::Connect. Note that this process can be time-intensive and thus should be performed in sufficient time before transmissions are scheduled to begin. Connect, like all of the methods exposed by ATVEFSnd.dll, is synchronous and blocks until it finishes.