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

  • Artigo

[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