Share via

Método IDvdInfo2::GetButtonAtPosition (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 GetButtonAtPosition método recupera el botón ubicado en el punto especificado dentro de la ventana de presentación.

Sintaxis

HRESULT GetButtonAtPosition(
  [in]  POINT point,
  [out] ULONG *pulButtonIndex
);

Parámetros

[in] point

Posición actual del puntero del mouse tal y como se recupera a través del mensaje de WM_MOUSEMOVE Win32.

[out] pulButtonIndex

Recibe el índice (de 1 a 36) del botón en la posición actual del puntero del mouse.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT .

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 Argumento no válido.
E_POINTER
 El parámetro puButtonIndex no es válido.
VFW_E_DVD_NO_BUTTON
 No hay ningún botón en el punto.

Comentarios

Este método se suele llamar en respuesta a un movimiento de puntero del mouse dentro de una ventana de presentación del menú dvd. Asegúrese de comprobar si se ha realizado correctamente en HRESULT antes de intentar recuperar el número de botón; Este método solo establece el valor de puButtonIndex si se encuentra un botón en el punto especificado. Los botones de DVD no tienen necesariamente rectángulos resaltados, los rectángulos de botón pueden superponerse y los rectángulos de botón no siempre corresponden a la representación visual de los botones.

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

IDvdInfo2 (Interfaz)