Microsoft DirectX 9.0

IMpeg2Data::GetSection

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(
  PID  pid,
  TID  tid,
  PMPEG2_FILTER  pFilter,
  DWORD  dwTimeout,
  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 Values

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.

See Also