IDVB_BAT Interface

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.

The IDVB_BAT interface enables the client to get data from a bouquet association table (BAT). The IDvbSiParser::GetBAT method returns a pointer to this interface.

A bouquet is a collection of services that are marketed as one entity. A single bouquet may contain several transport streams that are delivered across different distribution media (satellite, cable, or terrestrial).

The BAT may contain one or more table-wide descriptors. In addition, each record in the BAT may have one or more descriptors. To get the table-wide descriptors, use the GetTableDescriptorByIndex or GetTableDescriptorByTag method. To get the record descriptors, use the GetRecordDescriptorByIndex or GetRecordDescriptorByTag method.

Methods

The IDVB_BAT interface inherits the methods of the IUnknown interface.

In addition, IDVB_BAT defines the following methods.

Method Description

ConvertNextToCurrent

Converts a next table to a current table.

GetBouquetId

Returns the bouquet identifier for the BAT.

GetCountOfRecords

Returns the number of records in the BAT.

GetCountOfTableDescriptors

Returns the number of table-wide descriptors in the BAT.

GetNextTable

Retrieves the next table that follows the current table.

GetRecordCountOfDescriptors

Returns the number of descriptors for a record in the BAT.

GetRecordDescriptorByIndex

Retrieves a descriptor for a specified record in the BAT.

GetRecordDescriptorByTag

Searches a record in the BAT for a descriptor with a specified descriptor tag.

GetRecordOriginalNetworkId

Returns the original network identifier for a record in the BAT.

GetRecordTransportStreamId

Returns the transport stream identifier (TSID) for a record in the BAT.

GetTableDescriptorByIndex

Retrieves a table-wide descriptor for the BAT.

GetTableDescriptorByTag

Searches the BAT for a table-wide descriptor with the specified descriptor tag.

GetVersionNumber

Returns the version number for the BAT.

Initialize

Initializes the object.

RegisterForNextTable

Registers the client to be notified when a next table arrives that will replace the current table.

RegisterForWhenCurrent

Registers the client to be notified when the table becomes current.

Requirements

Header Declared in Dvbsiparser.h.

See Also

BDA Interfaces

Send comments about this topic to Microsoft

Build date: 12/4/2008