IDVB_SDT::GetRecordDescriptorByIndex Method

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.
The GetRecordDescriptorByIndex method retrieves a descriptor for a specified record in the SDT.


HRESULT GetRecordDescriptorByIndex(
  [in]   DWORD dwRecordIndex,
  [in]   DWORD dwIndex,
  [out]  IGenericDescriptor **ppDescriptor


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

  • dwIndex [in]
    Specifies which descriptor to retrieve, indexed from zero. Call the IDVB_SDT::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


NULL pointer argument.


Index out of bounds.


The method succeeded.


Header Declared in Dvbsiparser.h.

See Also

IDVB_SDT Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008