MSVidWebDVD.UOPValid Method
| Microsoft DirectShow 9.0 |
MSVidWebDVD.UOPValid Method
This topic applies to Windows XP Service Pack 1 or later.
The UOPValid method retrieves a value that indicates whether the specified user operation (UOP) is currently valid.
Syntax
VidWebDVD .UOPValid( lUOP As Long ) As Boolean
Parameters
lUOP
Specifies the user operation (UOP) as a Long. Values can include the following.
| Value | Description |
| 0 | PlayTitle, PlayAtTime, and PlayAtTimeInTitle |
| 1 | PlayChapter |
| 2 | PlayTitle |
| 3 | Stop (not enforced on the MSVidCtl object) |
| 4 | ReturnFromSubmenu |
| 5 | PlayChapter |
| 6 | PlayPrevChapter, ReplayChapter |
| 7 | PlayNextChapter |
| 8 | Forward play allowed. |
| 9 | Backward play allowed. |
| 10 | ShowMenu with a parameter value of 2 (DVD_MENU_Title). |
| 11 | ShowMenu with a parameter value of 3 (DVD_MENU_Root). |
| 12 | ShowMenu with a parameter value of 4 (DVD_MENU_Subpicture). |
| 13 | ShowMenu with a parameter value of 5 (DVD_MENU_Audio). |
| 14 | ShowMenu with a parameter value of 6 (DVD_MENU_Angle). |
| 15 | ShowMenu with a parameter value of 7 (DVD_MENU_Chapter). |
| 16 | Resume |
| 17 | SelectLeftButton, SelectRightButton, SelectUpperButton, and SelectLowerButton |
| 18 | StillOff |
| 19 | Pause (not enforced on the MSVidCtl object) |
| 20 | CurrentAudioStream |
| 21 | CurrentSubpictureStream |
| 22 | CurrentAngle, SelectParentalLevel |
| 23 | KaraokeAudioPresentationMode |
| 24 | Select video mode preference. |
Return Values
Returns a Boolean indicating whether the specified operation is permitted.
Error Codes
If the property fails, Err.Number may be set to one of the following values.
| Value | Description |
| E_UNEXPECTED | Unspecified error. |
| E_INVALIDARG | UOP number less than 0 or greater than 24 entered. |
Remarks
DVD authors can encode the disc to enable or disable certain commands by the user. These user operations (UOP) generally handle disc navigation. Attempting to access a property or method that is not currently allowed or valid will cause your application to raise an error. UOPValid allows you to determine if you can access a method or property to avoid such errors.
In addition to avoiding run-time errors, UOPValid allows you to visibly disable controls for prohibited actions on the user interface.
Certain methods—Stop, Pause, and Run—apply to both the MSVidWebDVD object and the MSVidCtl object. These methods should be run from the MSVidCtl object, or your application will raise an error. Disc permissions cannot prevent the MSVidCtl object from implementing these methods even when the UOPValid method returns false. However, an application designer may choose to disable user controls for these methods when the UOP value is false.
Example
' Check if forward or reverse play is allowed before changing playback rate. dRate = txtRate.Text If oVidWebDVD.UOPValid(&H80) And dRate > 0 Then ' Handle forward. oVidWebDVD.Rate = dRate ElseIf oVidWebDVD.UOPValid(&H100) And dRate < 0 Then ' Handle reverse. oVidWebDVD.Rate = dRate End If
Requirements
Reference: Add a reference to MS Video Control 1.0 Type Library and Microsoft Tuner 1.0 Type Library.
Library: Quartz.dll.
See Also