IPMT::GetRecordDescriptorByIndex Method

  • Article

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

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

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

  • ppDescriptor [out]
    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

Header Declared in Mpeg2PsiParser.h.

See Also

IPMT Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008