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

  • Artículo

[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 ActivateAtPosition método activa el botón de menú bajo la posición del puntero del mouse.

Sintaxis

HRESULT ActivateAtPosition(
  [in] POINT point
);

Parámetros

[in] point

Apunte al área de la ventana del cliente, en coordenadas de píxeles de pantalla.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
 El clic se produjo en el rectángulo del botón resaltado y el botón se activó correctamente.
E_INVALIDARG
 El punto está fuera de la región de vídeo válida.
E_UNEXPECTED
 El botón está presente, pero no funciona.
VFW_E_DVD_INVALIDDOMAIN
 El navegador de DVD no está en un dominio de menú.
VFW_E_DVD_NO_BUTTON
 No hay ningún botón de menú bajo la posición del puntero del mouse.
VFW_E_DVD_OPERATION_INHIBITED
 El control de operación del usuario (UOP) impide la operación.

Comentarios

Las coordenadas del puntero del mouse son relativas a la parte superior izquierda del área de cliente, que no es necesariamente el área de visualización de vídeo si el vídeo está en formato de cuadro de letras.

Use este método cuando el usuario navegue por un menú moviendo el puntero del mouse directamente sobre los botones de menú. Si el usuario usa los botones relativos para navegar por el menú, use ActivateButton en lugar de ActivateAtPosition.

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
None
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu

Requisitos

Requisito Value
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