Edit

IDvdInfo::GetCurrentUOPS method (strmif.h)

  • Article

[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.]

Note  The IDvdInfo interface is deprecated. Use IDvdInfo2 instead.
 
Retrieves which IDvdControl methods are currently valid.

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
E_UNEXPECTED
 DVD is not initialized or domain is not DVD_DOMAIN_Title.
S_OK
 Success.
VFW_E_DVD_INVALIDDOMAIN
 Requested action is not supported on this domain (DVD_DOMAIN).
VFW_E_DVD_OPERATION_INHIBITED
 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)

See also

Error and Success Codes

IDvdInfo Interface