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.

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.

Requisitos

Confira também

Aplicativos DE DVD

Códigos de erro e êxito

IDvdControl2 Interface

Trabalhando com menus de DVD