Método IDvdControl2::ShowMenu (strmif.h)
[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 |
|---|---|
|
Correcto. |
|
El parámetro MenuID no es válido. |
|
dominio no válido. |
|
El menú especificado no existe. |
|
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 |