Share via


IDVB_NIT Interface

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

The IDVB_NIT interface enables the client to get information from a network information table (NIT). The IDvbSiParser::GetNIT method returns a pointer to this interface.

A NIT contains information about the network and the physical organization of the transport streams. Because a network typically carries more than one transport stream, the NIT can provide information for tuning and for locating particular transport streams. A NIT carried on one network may contain information about another network.

The original_network_id and transport_stream_id fields together uniquely define a transport stream within the network.

The NIT may contain one or more table-wide descriptors. In addition, each record in the NIT 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_NIT interface inherits the methods of the IUnknown interface.

In addition, IDVB_NIT defines the following methods.

Method Description

ConvertNextToCurrent

Converts a next table to a current table.

GetCountOfRecords

Returns the number of records in the NIT.

GetCountOfTableDescriptors

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

GetNetworkId

Returns the network identifier for the NIT.

GetNextTable

Retrieves the next table that follows the current table.

GetRecordCountOfDescriptors

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

GetRecordDescriptorByIndex

Retrieves a descriptor for a specified record in the NIT.

GetRecordDescriptorByTag

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

GetRecordOriginalNetworkId

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

GetRecordTransportStreamId

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

GetTableDescriptorByIndex

Retrieves a table-wide descriptor for the NIT.

GetTableDescriptorByTag

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

GetVersionHash

Returns a hash value for this table instance.

GetVersionNumber

Returns the version number for the NIT.

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