GetTitleParentalLevels Method
| Microsoft DirectShow 9.0 |
GetTitleParentalLevels Method
This component is available for use in the Microsoft Windows 2000, Windows XP, and Windows Server 2003 operating systems. It may be altered or unavailable in subsequent versions.
The GetTitleParentalLevels method retrieves the parental management levels for the specified title.
Syntax
[ iLevels = ] MSWebDVD.GetTitleParentalLevels(iTitle);
Parameters
iTitle
Specifies the title as an Integer.
Return Values
Returns an integer value whose individual bits indicate which parental management levels (PML) are set in the specified title.
Remarks
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 |
Example Code
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.
iLevels = oDVD.GetTitleParentalLevels(1); if(iLevels & 0x100) // PML 1 is defined for this title if(iLvels & 0x200) // PML 2 is defined for this title if(iLevels & 0x400) // PML 3 is defined for this title ... // and so on for all eight levels
See Also