IATSC_VCT::GetRecordName

 
Microsoft DirectShow 9.0

IATSC_VCT::GetRecordName

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

The GetRecordName method returns the name of a specified channel in the VCT.

Syntax

  HRESULT GetRecordName(
  DWORD  dwRecordIndex,
  WCHAR**  pwsName
);

Parameters

dwRecordIndex

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

pwsName

[out]  Receives a pointer to a wide-character string. The method allocates the buffer for the string. The caller must release the buffer by calling the CoTaskMemFree function.

Return Values

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

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

Remarks

This method returns the short_name field.

Requirements

Header: Include atscpsipparser.h.

See Also