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
S_OK
Operazione completata.
VFW_E_DVD_INVALIDDOMAIN
Lo strumento di navigazione DVD si trova in un dominio non valido.
VFW_E_DVD_OPERATION_INHIBITED
Il controllo UOP impedisce allo strumento di navigazione DVD di entrare in uno stato sospeso.
VFW_E_DVD_NO_BUTTON
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
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title

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

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia I AvessiControl2

Utilizzo dei menu DVD