IMpeg2Data::GetStreamOfSections method (mpeg2data.h)

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

[GetStreamOfSections 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 GetStreamOfSections method starts an ongoing request for specific MPEG-2 table sections.

Syntax

HRESULT GetStreamOfSections(
  [in]  PID           pid,
  [in]  TID           tid,
  [in]  PMPEG2_FILTER pFilter,
  [in]  HANDLE        hDataReadyEvent,
  [out] IMpeg2Stream  **ppMpegStream
);

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] hDataReadyEvent

Handle to an event created by the caller. The filter signals this event whenever it receives new data.

[out] ppMpegStream

Pointer to a variable that receives an IMpeg2Stream interface pointer. The caller must release the interface. Use this interface to retrieve the data when it arrives.

Return value

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

Return code	Description
E_INVALIDARG	Invalid argument.
E_POINTER	NULL pointer argument.
S_OK	The method succeeded.

Requirements

Requirement	Value
Target Platform	Windows
Header	mpeg2data.h

See also

IMpeg2Data Interface