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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O ShowMenu método exibe o menu especificado, se disponível.

Sintaxe

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

Parâmetros

[in] MenuID

Um DVD_MENU_ID valor de enumeração que especifica o menu a ser exibido.

[in] dwFlags

OR bit a bit de um ou mais sinalizadores da enumeração DVD_CMD_FLAGS , especificando como sincronizar o comando.

[out] ppCmd

Recebe um ponteiro para um objeto IDvdCmd que pode ser usado para sincronizar comandos de DVD. O chamador deve liberar a interface. Este parâmetro pode ser NULL. Para obter mais informações, consulte Sincronizando comandos de DVD.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	O parâmetro MenuID é inválido.
VFW_E_DVD_INVALIDDOMAIN	Domínio inválido.
VFW_E_DVD_MENU_DOES_NOT_EXIST	O menu especificado não existe.
VFW_E_DVD_OPERATION_INHIBITED	O controle UOP proíbe a operação.

Comentários

O Menu do Gerenciador de Vídeo (VMGM) deve estar acessível nos domínios Título ou Conjunto de Títulos de Vídeo. Os menus do Conjunto de Títulos de Vídeo (VTSMs) só podem estar acessíveis por meio da VMGM. Qualquer submenu em cada VTSM (para capítulos, ângulos e fluxos de áudio e subpictura) só pode ser acessado por meio desse VTSM.

Esse método é demonstrado no aplicativo de aplicativo DVDSample em CDvdCore::RootMenu e CDvdCore::TitleMenu.

A tabela a seguir mostra o nome do comando Anexo J ao qual esse nome de método corresponde e os domínios nos quais esse método é válido.

Nome do Comando Do Anexo J	Domínios válidos
Menu_Call	Todos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	strmif.h (inclua Dshow.h)
Biblioteca	Strmiids.lib

Confira também

Aplicativos DE DVD

Códigos de erro e êxito

IDvdControl2 Interface

Trabalhando com menus de DVD