Metodo IDeviceInfo2::GetButtonAtPosition (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetButtonAtPosition metodo recupera il pulsante che si trova nel punto specificato all'interno della finestra di visualizzazione.

Sintassi

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

Parametri

[in] point

Posizione del puntatore del mouse corrente recuperata tramite il messaggio di WM_MOUSEMOVE Win32.

[out] pulButtonIndex

Riceve l'indice (da 1 a 36) del pulsante nella posizione corrente del puntatore del mouse.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Argomento non valido.
E_POINTER	Il parametro puButtonIndex non è valido.
VFW_E_DVD_NO_BUTTON	Nessun pulsante in corrispondenza del punto.

Commenti

Questo metodo viene in genere chiamato in risposta a uno spostamento del puntatore del mouse all'interno di una finestra di visualizzazione del menu DVD. Assicurarsi di verificare l'esito positivo in HRESULT prima di provare a recuperare il numero del pulsante; questo metodo imposta solo il valore di puButtonIndex se viene trovato un pulsante nel punto specificato. I pulsanti DVD non hanno necessariamente rettangoli evidenziati, i rettangoli dei pulsanti possono sovrapporsi e i rettangoli dei pulsanti non corrispondono sempre alla rappresentazione visiva dei pulsanti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia IInfo2

Condividi tramite