metodo CBaseControlVideo.put_DestinationTop

[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 put_DestinationTop metodo imposta la coordinata superiore del rettangolo di destinazione.

Sintassi

HRESULT put_DestinationTop(
   long DestinationTop
);

Parametri

DestinationTop

Nuova coordinata superiore del rettangolo di destinazione.

Valore restituito

Restituisce un valore HRESULT che dipende dall'implementazione; può essere uno dei valori seguenti o altri valori non elencati.

Codice restituito Descrizione
E_FAIL
Esito negativo.
E_INVALIDARG
Argomento non valido.
E_POINTER
Argomento puntatore NULL.
NOERROR
Operazione completata.
VFW_E_NOT_CONNECTED
Impossibile eseguire l'operazione perché i pin non sono connessi.

Commenti

Un'applicazione può modificare i rettangoli di origine e di destinazione per il video tramite l'interfaccia IBasicVideo . Il rettangolo di origine influisce sulla sezione dell'origine video nativa visualizzata sullo schermo; il rettangolo di destinazione influisce sulla posizione in cui verrà visualizzato il video durante la riproduzione. Il rettangolo di destinazione è relativo all'area client della finestra in cui viene riprodotta. L'angolo superiore sinistro della finestra è la coordinata (0,0).

Requisiti

Requisito Valore
Intestazione
Ctlutil.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseControlVideo