Condividi tramite


CBaseControlVideo.put_SourceTop metodo

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

Sintassi

HRESULT put_SourceTop(
   long SourceTop
);

Parametri

SourceTop

Nuova coordinata superiore del rettangolo di origine.

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 nella visualizzazione; 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 è coordinata (0,0).

Requisiti

Requisito Valore
Intestazione
Ctlutil.h (includere Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseControlVideo