Share via

IATSC_VCT::GetRecordDescriptorByIndex method (atscpsipparser.h)

  • Article

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

This topic applies to Update Rollup 2 for Microsoft Windows XP Media Center Edition 2005 and later.

The GetRecordDescriptorByIndex method returns a descriptor for a specified record in the VCT.

Syntax

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

Parameters

[in] dwRecordIndex

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

[in] dwIndex

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

[out] ppDescriptor

Receives a pointer to the IGenericDescriptor interface. 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
MPEG2_E_OUT_OF_BOUNDS
 Index out of bounds.
S_OK
 The method succeeded.

Requirements

Requirement Value
Target Platform Windows
Header atscpsipparser.h

See also

IATSC_VCT Interface