IDvdControl::ParentalLevelSelect method (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Syntax
HRESULT ParentalLevelSelect(
ULONG ulParentalLevel
);
Parameters
ulParentalLevel
Value that specifies the current media file parental access level. Should be a value from 1 to 8, inclusive. Predefined parental levels are as follows:
| Value | Description |
|---|---|
| 1 | The rating is G, General. |
| 3 | The rating is PG, Parental Guidance Suggested. |
| 4 | The rating is PG-13, Parental Guidance Suggested, not recommended for those under 13. |
| 6 | The rating is R, Restricted. |
| 7 | The rating is NC-17. |
Return value
Returns an HRESULT value.
Remarks
This method returns an error unless the domain is DVD_DOMAIN_Stop. For more information, see DVD_DOMAIN.
This method sets the current user's access level; this access level determines what media files the user can play back. Higher levels can play lower-level content; lower levels can't play higher-level content. For example, adults can watch child-safe content, but children can't watch adult content.
The DVD Navigator filter provides no restriction on setting the parental level. DVD player applications can enforce restrictions on the parental level setting, such as providing password protection for raising the current parental level. Parental management in the DVD Navigator is disabled by default.
To disable parental management, pass 0xffffffff for ulParentalLevel. If parental management is disabled, then the player will play the first program chain (PGC) in a parental block regardless of parental IDs.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Reference:_Dshowh |
| Target Platform | Windows |
| Header | strmif.h |
| DLL | Quartz.dll |