IDvdControl2::ReturnFromSubmenu method

The ReturnFromSubmenu method returns the display from a submenu to its parent menu.

Syntax


HRESULT ReturnFromSubmenu(
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

dwFlags [in]: Bitwise OR of one or more flags from the DVD_CMD_FLAGS enumeration, specifying how to synchronize the command.
ppCmd [out]: Receives a pointer to an IDvdCmd object that can be used to synchronize DVD commands. The caller must release the interface. This parameter can be NULL. For more information, see Synchronizing DVD Commands.

Returns one of the following values.

Return code	Description
S_OK	Success.
VFW_E_DVD_OPERATION_INHIBITED	UOP control prohibits the operation.
VFW_E_DVD_NO_GOUP_PGC	The operation cannot be performed because no GoUp program chain (PGC) is available.

If the DVD Navigator is at the top-level menu, this method calls the IDvdControl2::Resume method so that play continues where it left off.

The following table shows the Annex J command name to which this method name corresponds, and the domains in which this method is valid.

Annex J Command Name	Valid Domains
GoUP	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Strmif.h (include Dshow.h)
Library	Strmiids.lib