IAtscPsipParser::GetETT method (atscpsipparser.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

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

[in] pid

Specifies the packet identifier (PID) for the requested ETT.

[in] wSourceId

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.

[in] pwEventId

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.

[out] ppETT

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

Requirement Value
Target Platform Windows
Header atscpsipparser.h

See also

IAtscPsipParser Interface