IDVB_BAT Interface

Microsoft DirectShow 9.0

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.

In addition to the methods inherited from IUnknown, the IDVB_BAT interface exposes 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.


Header: Include dvbsiparser.h.

See Also