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

Artigo
03/02/2024

[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 ReturnFromSubmenu método retorna a exibição de um submenu para seu menu pai.

Sintaxe

HRESULT ReturnFromSubmenu(
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parâmetros

[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.
VFW_E_DVD_OPERATION_INHIBITED	O controle UOP proíbe a operação.
VFW_E_DVD_NO_GOUP_PGC	A operação não pode ser executada porque nenhuma cadeia de programas GoUp (PGC) está disponível.

Comentários

Se o DVD Navigator estiver no menu de nível superior, esse método chamará o método IDvdControl2::Resume para que a reprodução continue de onde parou.

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
GoUP	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title

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