IDvbSiParser::GetNIT Method

Article
01/07/2009

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.
The GetNIT method retrieves the network information table (NIT).

Syntax

HRESULT GetNIT(
  [in]   TID tableId,
  [in]   WORD *pwNetworkId,
  [out]  IDVB_NIT **ppNIT
);

Parameters

tableId [in]
Specifies the table identifier of the NIT. Use one of the values in the following table.

Value Description

DVB_NIT_ACTUAL_TID (0x40) NIT for the network that carries this transport stream.

DVB_NIT_OTHER_TID (0x41) NIT for another network.
pwNetworkId [in]
Optional parameter that contains a network identifier. You can use this value to filter the request. Otherwise, set this parameter to NULL.
ppNIT [out]
Address of a variable that receives an IDVB_NIT interface pointer. The caller must release the interface.

Value	Description
DVB_NIT_ACTUAL_TID (0x40)	NIT for the network that carries this transport stream.
DVB_NIT_OTHER_TID (0x41)	NIT for another network.

Return Value

The method returns an HRESULT. Possible values include those in the following table.

Return code	Description
E_INVALIDARG	Invalid argument.
E_POINTER	NULL pointer argument.
MPEG2_E_SECTION_NOT_FOUND	The filter did not receive the table in the allotted time.
S_OK	The method succeeded.

Remarks

The method fails if the filter does not receive a matching table within a predetermined length of time.

Requirements

Header

Declared in Dvbsiparser.h.