MSVidWebDVD.TitleParentalLevels Property

Article
07/09/2010

Note This topic applies to Windows XP Service Pack 1 or later.

The TitleParentalLevels property retrieves the parental management levels for the specified title.

VidWebDVD.TitleParentalLevels(
   lTitle As Long
) As Long

Parameters

lTitle
Long value specifying a title.

Return Value

Returns a Long value whose individual bits indicate which parental management levels (PML) are set in the specified title.

Error Codes

If the property fails, Err.Number may be set to one of the following values.

Value	Description
E_UNEXPECTED	Unspecified error; possibly the graph has not been built.
E_INVALIDARG	Invalid argument.

Remarks

This property is read-only. A title may have chapters or even short segments that have a PML different from the overall PML for the title. Use this method to determine all the PMLs that will be encountered when playing a specified title. The returned integer is a set of bit flags that are defined as shown in the table below. Perform a bitwise AND operation on iLevels and each possible value. If the operation returns True, it means that PML will be encountered at some point in this title.

Value	Description
0x100	DVD parental level 1
0x200	DVD parental level 2
0x400	DVD parental level 3
0x800	DVD parental level 4
0x1000	DVD parental level 5
0x2000	DVD parental level 6
0x4000	DVD parental level 7
0x8000	DVD parental level 8

Examples

The following code snippet shows how to test for PMLs on Title 1. One use for this information is to compare the highest PML defined for the title to the PML assigned to the current user and determine whether to play the specified title or not.

' Hexadecimal values shown in VB style. 
lLevels = oVidWebDVD.TitleParentalLevels(lTitle)
If(lLevels And &H100) Then 
   'PML 1 is defined for this title
End If
If(lLevels And &H200) Then 
   ' PML 2 is defined for this title
End If
If(lLevels And &H400) Then
  ' PML 3 is defined for this title
End If
' And so on for all eight levels...

Requirements

Type Library	MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library
DLL	Quartz.dll