IDvdInfo::GetCurrentUOPS 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 GetCurrentUOPS(
[out] VALID_UOP_SOMTHING_OR_OTHER *pUOP
);
Parameters
[out] pUOP
Pointer to a DWORD value containing bits for all user operations (UOP). Each bit in the DWORD represents the state (valid or not valid) of a user operation. If the bit corresponding to a user operation is set, then that user operation is prohibited. For more information, see Remarks.
Return value
Returns an HRESULT value.
| Return code | Description |
|---|---|
|
DVD is not initialized or domain is not DVD_DOMAIN_Title. |
|
Success. |
|
Requested action is not supported on this domain (DVD_DOMAIN). |
|
Requested action cannot occur at this point in the movie due to the authoring of the current DVD-Video disc. |
Remarks
This method is valid in any domain. For more information, see DVD_DOMAIN.
The value of pUOP is a bit field defined as follows.
| Bit | Flag | User function |
|---|---|---|
| 0 | UOP_FLAG_Title_Or_Time_Play | TitlePlay, TimePlay |
| 1 | UOP_FLAG_Chapter_Search_Or_Play | ChapterSearch, ChapterPlay |
| 2 | UOP_FLAG_Title_Play | TitlePlay |
| 3 | UOP_FLAG_Stop | StopForResume |
| 4 | UOP_FLAG_GoUp | GoUp |
| 5 | UOP_FLAG_Time_Or_Chapter_Search | TimeSearch, ChapterSearch |
| 6 | UOP_FLAG_Prev_Or_Top_PG_Search | PrevPGSearch, TopPGSearch |
| 7 | UOP_FLAG_Next_PG_Search | NextPGSearch |
| 8 | UOP_FLAG_Forward_Scan | ForwardScan |
| 9 | UOP_FLAG_Backward_Scan | BackwardScan |
| 10 | UOP_FLAG_Title_Menu_Call | MenuCall with a parameter value of 2 (DVD_MENU_Title) |
| 11 | UOP_FLAG_Root_Menu_Call | MenuCall with a parameter value of 3 (DVD_MENU_Root) |
| 12 | UOP_FLAG_SubPic_Menu_Call | MenuCall with a parameter value of 4 (DVD_MENU_Subpicture) |
| 13 | UOP_FLAG_Audio_Menu_Call | MenuCall with a parameter value of 5 (DVD_MENU_Audio) |
| 14 | UOP_FLAG_Angle_Menu_Call | MenuCall with a parameter value of 6 (DVD_MENU_Angle) |
| 15 | UOP_FLAG_Chapter_Menu_Call | MenuCall with a parameter value of 7 (DVD_MENU_Chapter) |
| 16 | UOP_FLAG_Resume | Resume |
| 17 | UOP_FLAG_Button_Select_Or_Activate | UpperButtonSelect, LowerButtonSelect, LeftButtonSelect, RightButtonSelect, ButtonActivate, ButtonSelectAndActivate |
| 18 | UOP_FLAG_Still_Off | StillOff |
| 19 | UOP_FLAG_Pause_On | PauseOn, MenuLanguageSelect |
| 20 | UOP_FLAG_Audio_Stream_Change | AudioStreamChange |
| 21 | UOP_FLAG_SubPic_Stream_Change | SubpictureStreamChange |
| 22 | UOP_FLAG_Angle_Change | AngleChange, ParentalLevelSelect |
| 23 | UOP_FLAG_Karaoke_Audio_Pres_Mode_Change | KaraokeAudioPresentationModeChange |
| 24 | UOP_FLAG_Video_Pres_Mode_Change | VideoModePreferrence |
This method is useful because DVD titles can enable or disable individual user operations at almost any point during playback.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |