ISectionList::GetSectionData Method

Article
01/07/2009

The GetSectionData method retrieves a section.

Syntax

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

Parameters

sectionNumber [in]
Specifies the section number to retrieve, indexed from zero. Call the GetNumberOfSections method to get the number of sections.
pdwRawPacketLength [out]
Receives the size of the section data, in bytes.
ppSection [out]
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.

Return code	Description
E_ACCESSDENIED	The request has not completed yet.
E_POINTER	NULL pointer argument.
MPEG2_E_OUT_OF_BOUNDS	The section number is out of range.
S_OK	The method succeeded.

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

Header

Declared in Mpeg2data.h.

Share via