ISectionList::GetSectionData 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.]

The GetSectionData method retrieves a section.

Syntax

HRESULT GetSectionData(
  [in]  WORD     sectionNumber,
  [out] DWORD    *pdwRawPacketLength,
  [out] PSECTION *ppSection
);

Parameters

[in] sectionNumber

Specifies the section number to retrieve, indexed from zero. Call the GetNumberOfSections method to get the number of sections.

[out] pdwRawPacketLength

Receives the size of the section data, in bytes.

[out] ppSection

Address of a variable that receives a pointer to a SECTION structure, containing the section data. Do not free the memory for the structure; the object frees the memory when the interface is released.

Return value

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

Remarks

The section header is converted from network byte order to native byte order. The number of header bytes that are converted depends on the header type. The header types are short header (SECTION structure), long header (LONG_SECTION structure), or DSM-CC header (DSMCC_SECTION structure). If the section has a short header, the first three bytes are converted; for a long header, the first eight bytes are converted; and for a DSM-CC header, the first 20 bytes are converted.

The body of the section data, after the header, is left unparsed and unconverted.

Requirements

See also

ISectionList Interface