Share via

IMpeg2Data::GetSection Method

  • Article

The GetSection method retrieves an MPEG-2 table section. This method blocks until the filter receives a matching table section, or until the specified time out elapses.

Syntax

HRESULT GetSection(
  [in]   PID pid,
  [in]   TID tid,
  [in]   PMPEG2_FILTER pFilter,
  [in]   DWORD dwTimeout,
  [out]  ISectionList **ppSectionList
);

Parameters

  • pid [in]
    Specifies the packet identifier (PID) of the transport stream packets to examine.

  • tid [in]
    Specifies the table identifier (TID) of the section to retrieve.

  • pFilter [in]
    Optional pointer to an MPEG2_FILTER structure. The caller can use this parameter to exclude packets based on additional MPEG-2 header fields. This parameter can be NULL.

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

  • ppSectionList [out]
    Pointer to a variable that receives an ISectionList interface pointer. Use this interface to retrieve the section data. The caller must release the interface.

Return Value

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

Return code Description

S_OK

The method succeeded.

E_INVALIDARG

Invalid argument.

MPEG2_E_SECTION_NOT_FOUND

The filter did not receive a matching table section.

Requirements

Header Declared in Mpeg2data.h.

See Also

IMpeg2Data Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008