IAtscPsipParser::GetETT

 
Microsoft DirectShow 9.0

IAtscPsipParser::GetETT

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(
  PID  pid,
  WORD*  wSourceId,
  WORD*  pwEventId,
  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 Values

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: Include atscpsipparser.h.

See Also