Platform SDK: Broadcast Architecture

IATVEFPackage

The IATVEFPackage interface creates a package of one or more enhancement files, such as HTML pages, graphics, scripts, and so on, that are associated with one particular interactive television show.

When to Implement

Implemented by CATVEFPackage in ATVEFSnd.dll.

When to Use

A content server application uses the methods of IATVEFPackage to create packages of enhancement files.

Methods in Vtable Order

IUnknown method Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.

IATVEFPackage method Description
Initialize Initializes a new package.
AddFile Adds a file to a package.
Close Closes a package so that it can be sent.
GetTransmitTime Returns the time needed to transmit a package.

Remarks

A package is a MIME-encoded archive as specified in the ATVEF foundation specification 1.1. Any or all of the files in the package can be gzip compressed at the time they are added. There is only one package associated with the package object at any given time. After a package is closed, it remains available to be sent.

If your application needs to transmit more than one package, it should create multiple CATVEFPackage objects as described in Co-creating a Package Class Instance.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 98.
  Header: Declared in atvefsnd.idl.
  Import Library: Included as a resource in atvefsnd.dll.

See Also

Creating Packages