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. |
Requirements
Header: Include dvbsiparser.h.
See Also