IDvbSiParser::GetCAT method (dvbsiparser.h)

Article
12/05/2018

[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 GetCAT method retrieves the conditional access table (CAT).

Syntax

HRESULT GetCAT(
  [in]  DWORD dwTimeout,
  [out] ICAT  **ppCAT
);

Parameters

[in] dwTimeout

Specifies a time-out value, in milliseconds. If the filter does not receive the data within the time-out period, the method fails.

[out] ppCAT

Address of a variable that receives an ICAT 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_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 returns the first CAT that is marked current; that is, one in which the current_next_indicator bit is 1.

Requirements

Requirement	Value
Target Platform	Windows
Header	dvbsiparser.h

Share via