IXDSToRat::ParseXDSBytePair method (tvratings.h)
[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]
The ParseXDSBytePair method parses a single byte pair from an XDS stream. If the byte pair is the last pair in a completed ratings packet, the method returns the rating information.
Syntax
HRESULT ParseXDSBytePair(
[in] BYTE byte1,
[in] BYTE byte2,
[out] EnTvRat_System *pEnSystem,
[out] EnTvRat_GenericLevel *pEnLevel,
[out] LONG *plBfEnAttributes
);
Parameters
[in] byte1
The first byte of the byte pair.
[in] byte2
The second byte of the byte pair.
[out] pEnSystem
Receives the rating system, as a member of the EnTvRat_System enumeration type.
[out] pEnLevel
Receives the rating level, as a member of the EnTvRat_GenericLevel enumeration type. The meaning of this value depends on the rating system.
[out] plBfEnAttributes
Receives a bitwise combination of zero or more flags from the BfEnTvRat_GenericAttributes enumeration. These flags specify additional content attributes, such as violence or adult language. They do not apply to every rating system.
Return value
The method returns an HRESULT. Possible values include those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
No rating has been detected in the stream yet. |
Remarks
The XDS Codec filter calls this method to pass XDS data to the XDSToRat object, one pair of bytes at a time. The XDSToRat object must store enough information between calls to be able to parse a complete ratings packet.
This method returns S_FALSE until the XDSToRat object decodes a complete ratings packet. At that point, the method returns S_OK and returns the rating information in the pEnSystem, pEnLevel, and plBfEnAttributes parameters. Subsequent calls return S_FALSE again until the next packet is decoded.
Ratings values may be delivered by either the XDS Content Advisory packet, or the Composite Packet-1 packet. For details, see sections 9.5.1.5 and 9.5.1.10, respectively, of the EIA/CEA-608B specification.
This method should also detect the Current Class Program Identification Number and Program Name packets indicating the end of show and return an S_OK value along with the values in the following table.
Return the following values for non-ratings packets.
| Parameter | Value |
|---|---|
| pEnSystem | TvRat-SystemDontKnow |
| pEnLevel | TvRat_LevelDontKnow |
| plBfEnAttributes | BfAttrNone |
For details, see section 9.5.1.5.4 (General Content Advisory Requirements) of the EIA/CEA-608-B specification.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows�XP with SP1 [desktop apps only] |
| Minimum supported server | None supported |
| Target Platform | Windows |
| Header | tvratings.h |