Share via

IDvdControl2::ReturnFromSubmenu

  • Article
 
Microsoft DirectShow 9.0

IDvdControl2::ReturnFromSubmenu

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

Syntax

  HRESULT ReturnFromSubmenu(
  DWORD dwFlags,
  IDvdCmd **ppCmd
);

Parameters

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.

Return Values

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.

Remarks

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

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also