Metodo IDeviceControl2::ActivateButton (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 ActivateButton metodo attiva il pulsante di menu attualmente selezionato.
Sintassi
HRESULT ActivateButton();
Valore restituito
Restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Lo strumento di navigazione DVD si trova in un dominio non valido. |
|
Il controllo UOP impedisce allo strumento di navigazione DVD di entrare in uno stato sospeso. |
|
Non è selezionato alcun pulsante. |
Commenti
Un'applicazione potrebbe avere o meno quattro pulsanti relativi sul lato della visualizzazione video per rappresentare i pulsanti su un controllo remoto fisico. Questi consentono a un utente di selezionare i pulsanti di menu ma non di attivarli. Per attivare il pulsante selezionato è necessario un quinto pulsante. Chiamare ActivateButton in risposta a un clic del mouse sul quinto pulsante.
La tabella seguente illustra il nome del comando Allegato J a cui corrisponde questo nome di metodo e i domini in cui questo metodo è valido.
| Nome comando J allegato | Domini validi |
| Button_Activate |
|
Requisiti
| 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 |