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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 ActivateButton método ativa o botão de menu selecionado no momento.

Sintaxe

HRESULT ActivateButton();

Retornar valor

Retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	Êxito.
VFW_E_DVD_INVALIDDOMAIN	O Navegador de DVD está em um domínio inválido.
VFW_E_DVD_OPERATION_INHIBITED	O controle UOP proíbe que o Navegador de DVD entre em um estado em pausa.
VFW_E_DVD_NO_BUTTON	Nenhum botão está selecionado.

Comentários

Um aplicativo pode ou não ter quatro botões relativos na lateral da exibição do vídeo para representar os botões em um controle remoto físico. Isso permite que um usuário selecione botões de menu, mas não os ative. Um quinto botão é necessário para ativar o botão selecionado. Chame ActivateButton em resposta a um clique do mouse no quinto botão.

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 Anexo J	Domínios válidos
Button_Activate	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title

Requisitos

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