| Microsoft DirectX 9.0 |
The GetSectionData method retrieves a section.
Syntax
HRESULT GetSectionData(
WORD sectionNumber,
DWORD* pdwRawPacketLength,
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] Pointer to a variable that 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 Values
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.
See Also