Método IDvdInfo2::GetButtonAtPosition (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 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 |
|---|---|
|
Correcto. |
|
Argumento no válido. |
|
El parámetro puButtonIndex no es válido. |
|
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 |