IAtscPsipParser::GetVCT Method

Article
01/07/2009

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.
The GetVCT method retrieves the virtual channel table (VCT).

Syntax

HRESULT GetVCT(
  [in]   TID tableId,
  [in]   BOOL fGetNextTable,
  [out]  IATSC_VCT **ppVCT
);

Parameters

tableId [in]
Specifies the table identifier (TID) of the VCT. Use one of the following values, declared in mpeg2data.h.

Value Description

ATSC_VCT_CABL_TID (0xC9) Cable

ATSC_VCT_TERR_TID (0xC8) Terrestrial
fGetNextTable [in]
Boolean value that indicates whether to search for the current table or the next table. If the value is TRUE, the method searches for a table with the current_next_indicator flag set to 1. Otherwise, the method searches for a table with the current_next_indicator flag set to 0.
ppVCT [out]
Receives an IATSC_VCT interface pointer. The caller must release the interface.

Value	Description
ATSC_VCT_CABL_TID (0xC9)	Cable
ATSC_VCT_TERR_TID (0xC8)	Terrestrial

Return Value

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

Return code	Description
E_INVALIDARG	Invalid argument.
E_OUTOFMEMORY	Insufficient memory.
E_POINTER	NULL pointer argument.
MPEG2_E_SECTION_NOT_FOUND	The filter did not receive the table in the allotted time.
MPEG2_E_UNINITIALIZED	The Initialize method was not called.
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 Atscpsipparser.h.

Share via