Metodo IDeviceControl2::ActivateAtPosition (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il ActivateAtPosition metodo attiva il pulsante del menu sotto la posizione del puntatore del mouse.

Sintassi

HRESULT ActivateAtPosition(
  [in] POINT point
);

Parametri

[in] point

Puntare nell'area della finestra client, nelle coordinate pixel dello schermo.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
S_OK
Il clic si è verificato nel rettangolo del pulsante evidenziato e il pulsante è stato attivato correttamente.
E_INVALIDARG
Il punto si trova all'esterno dell'area video valida.
E_UNEXPECTED
Il pulsante è presente ma non funziona.
VFW_E_DVD_INVALIDDOMAIN
Il navigatore DVD non è in un dominio di menu.
VFW_E_DVD_NO_BUTTON
Non c'è alcun pulsante di menu sotto la posizione del puntatore del mouse.
VFW_E_DVD_OPERATION_INHIBITED
L'operazione è inibita dal controllo UOP (User Operation).

Commenti

Le coordinate del puntatore del mouse sono relative alla parte superiore sinistra dell'area client, che non è necessariamente l'area di visualizzazione video se il video è in formato letterabox.

Usare questo metodo quando l'utente passa attraverso un menu spostando il puntatore del mouse direttamente sui pulsanti di menu. Se l'utente usa i pulsanti relativi per spostarsi nel menu, usare ActivateButton anziché ActivateAtPosition.

Nella tabella seguente viene illustrato il nome del comando Allegato J a cui corrisponde il nome del metodo e i domini in cui questo metodo è valido.

Nome comando J allegato Domini validi
Nessuno
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu

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 errore e esito positivo

Interfaccia ICollectionControl2

Uso dei menu DVD