Share via


IPMT::GetRecordDescriptorByIndex method (mpeg2psiparser.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 GetRecordDescriptorByIndex method retrieves a descriptor for a specified record in the PMT.

Syntax

HRESULT GetRecordDescriptorByIndex(
  [in]  DWORD              dwRecordIndex,
  [in]  DWORD              dwDescIndex,
  [out] IGenericDescriptor **ppDescriptor
);

Parameters

[in] dwRecordIndex

Specifies the record number, indexed from zero. Call the IPMT::GetCountOfRecords method to get the number of records in the PMT.

[in] dwDescIndex

Specifies which descriptor to retrieve, indexed from zero. Call the IPMT::GetRecordCountOfDescriptors method to get the number of descriptors for a particular record.

[out] ppDescriptor

Address of a variable that receives an IGenericDescriptor interface pointer. Use this interface to retrieve the information in the descriptor. The caller must release the interface.

Return value

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

Return code Description
E_POINTER
NULL pointer argument.
MPEG2_E_OUT_OF_BOUNDS
Index out of bounds.
S_OK
The method succeeded.

Requirements

Requirement Value
Target Platform Windows
Header mpeg2psiparser.h

See also

IPMT Interface