Share via


IDVB_NIT Interface

 
Microsoft DirectShow 9.0

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.

In addition to the methods inherited from IUnknown, the IDVB_NIT interface exposes 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: Include dvbsiparser.h.

See Also