IAtscPsipParser::GetCAT

Microsoft DirectShow 9.0

IAtscPsipParser::GetCAT

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(
  DWORD  dwTimeout,
  ICAT**  ppCAT
);

Parameters

dwTimeout

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

ppCAT

[out]  Receives an ICAT 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 returns the first CAT that is marked current; that is, one in which the current_next_indicator bit is 1.

Requirements

Header: Include atscpsipparser.h.

See Also

• IAtscPsipParser Interface