Microsoft DirectX 8.1 (C++)

IDvdInfo::GetCurrentUOPS

Note   The IDvdInfo interface is deprecated.

Retrieves which IDvdControl methods are currently valid.

Syntax

HRESULT GetCurrentUOPS(
    VALID_UOP_SOMTHING_OR_OTHER *pUOP
);

Parameters

pUOP

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

See Also