IAtscPsipParser::GetETT Method

Article
2009-01-07

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.
The GetETT method retrieves the extended text table (ETT).

Syntax

HRESULT GetETT(
  [in]   PID pid,
  [in]   WORD *wSourceId,
  [in]   WORD *pwEventId,
  [out]  IATSC_ETT **ppETT
);

Parameters

pid [in]
Specifies the packet identifier (PID) for the requested ETT.
wSourceId [in]
Optional pointer to a variable that contains a table source identifier. You can use this value to filter the request. Otherwise, set this parameter to NULL.
pwEventId [in]
Optional pointer to a variable that contains a table event identifier. You can use this value to filter the request. Otherwise, set this parameter to NULL.
ppETT [out]
Receives an IATSC_ETT interface pointer. The caller must release the interface.

Return Value

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

Return code	Description
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