IAtscContentAdvisoryDescriptor Interface

 
Microsoft DirectShow 9.0

IAtscContentAdvisoryDescriptor Interface

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

The IAtscContentAdvisoryDescriptor interface enables the client to get a content advisory descriptor from a Program and System Information Protocol (PSIP) table in an ATSC stream. The content advisor descriptor may be present in the event information table (EIT). For more information, refer to ATSC Standard A/65B, Program and System Information Protocol for Terrestrial Broadcast and Cable (Revision B).

In addition to the methods inherited from IUnknown, the IAtscContentAdvisoryDescriptor interface exposes the following methods.

Method Description
GetLength Returns the length of the descriptor body.
GetRatingRegionCount Returns the number of rating regions.
GetRecordRatedDimensions Returns the number of rating dimensions for a specified rating region.
GetRecordRatingDescriptionText Returns the rating description for a specified rating region.
GetRecordRatingDimension Returns the dimension index into the rating region table (RRT) for a specified region.
GetRecordRatingRegion Returns the rating region at a specified index.
GetRecordRatingValue Returns the rating value of a specified rating dimension.
GetTag Returns the descriptor tag.

Remarks

To obtain a pointer to this interface, do the following:

  1. Call IAtscPsipParser::GetEIT to get the IATSC_EIT interface.
  2. Call IATSC_EIT::GetRecordDescriptorByTag and pass in the content advisory descriptor tag (0x87). If the descriptor is present, the method returns an IGenericDescriptor pointer.
  3. Query the returned IGenericDescriptor pointer for the IAtscContentAdvisoryDescriptor interface.

Requirements

Header: Include atscpsipparser.h.

See Also