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 |
|---|---|
|
Êxito. |
|
O Navegador de DVD está em um domínio inválido. |
|
O controle UOP proíbe que o Navegador de DVD entre em um estado em pausa. |
|
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 |
|
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 |