Compartir a través de

Método IDvdControl2::ShowMenu (strmif.h)

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El ShowMenu método muestra el menú especificado, si está disponible.

Sintaxis

HRESULT ShowMenu(
  [in]  DVD_MENU_ID MenuID,
  [in]  DWORD       dwFlags,
  [out] IDvdCmd     **ppCmd
);

Parámetros

[in] MenuID

Valor de enumeración DVD_MENU_ID que especifica el menú que se va a mostrar.

[in] dwFlags

OR bit a bit de una o varias marcas de la enumeración DVD_CMD_FLAGS , especificando cómo sincronizar el comando.

[out] ppCmd

Recibe un puntero a un objeto IDvdCmd que se puede usar para sincronizar comandos de DVD. El autor de la llamada debe liberar la interfaz . Este parámetro puede ser NULL. Para obtener más información, vea Sincronizar comandos de DVD.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 El parámetro MenuID no es válido.
VFW_E_DVD_INVALIDDOMAIN
 dominio no válido.
VFW_E_DVD_MENU_DOES_NOT_EXIST
 El menú especificado no existe.
VFW_E_DVD_OPERATION_INHIBITED
 El control UOP prohíbe la operación.

Comentarios

El menú del Administrador de vídeos (VMGM) debe ser accesible desde los dominios Título o Conjunto de títulos de vídeo. Es posible que solo se pueda acceder a los menús del conjunto de títulos de vídeo (VMMS) a través de VMGM. Los submenús de cada VTSM (para capítulos, ángulos y secuencias de audio y subpictura) solo son accesibles a través de ese VTSM.

Este método se muestra en la aplicación de aplicación DVDSample en CDvdCore::RootMenu y CDvdCore::TitleMenu.

En la tabla siguiente se muestra el nombre del comando Anexo J al que corresponde este nombre de método y los dominios en los que este método es válido.

Nombre de comando de Anexo J Dominios válidos
Menu_Call Todos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

Interfaz IDvdControl2

Trabajar con menús de DVD