IMpeg2Data::GetSection method (mpeg2data.h)

  • Article

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

[GetSection is no longer available for use as of Windows�7. Instead, use the IPSITables interface to get program specific information (PSI) tables from an MPEG-2 transport stream.]

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

[in] pid

Specifies the packet identifier (PID) of the transport stream packets to examine.

[in] tid

Specifies the table identifier (TID) of the section to retrieve.

[in] pFilter

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.

[in] dwTimeout

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

[out] ppSectionList

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

   
Target Platform Windows
Header mpeg2data.h

See also

IMpeg2Data Interface