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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El ActivateButton método activa el botón de menú seleccionado actualmente.

Sintaxis

HRESULT ActivateButton();

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
Correcto.
VFW_E_DVD_INVALIDDOMAIN
El navegador de DVD está en un dominio no válido.
VFW_E_DVD_OPERATION_INHIBITED
El control UOP prohíbe que el navegador de DVD entre en un estado en pausa.
VFW_E_DVD_NO_BUTTON
No hay ningún botón seleccionado.

Observaciones

Una aplicación podría tener o no cuatro botones relativos en el lado de la pantalla de vídeo para representar los botones en un control remoto físico. Estos permiten a un usuario seleccionar botones de menú, pero no activarlos. Se requiere un quinto botón para activar el botón seleccionado. Llame ActivateButton a en respuesta a un clic del mouse en el quinto botón.

En la tabla siguiente se muestra el nombre del comando Anexo J al que corresponde este nombre de método y los dominios en los que este método es válido.

Nombre del comando Anexo J Dominios válidos
Button_Activate
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluye Dshow.h)
Library Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdControl2 (interfaz)

Trabajar con menús de DVD