Metodo IDeviceInfo2::GetButtonAtPosition (strmif.h)

[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.

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

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia IInfo2