Condividi tramite


Metodo CBaseControlVideo.GetSourcePosition

[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 GetSourcePosition metodo recupera la posizione e le dimensioni del rettangolo di origine in un'operazione atomica.

Sintassi

HRESULT GetSourcePosition(
   long *pLeft,
   long *pTop,
   long *pWidth,
   long *pHeight
);

Parametri

pLeft

Puntatore alla coordinata sinistra del rettangolo di origine.

pTop

Puntatore alla coordinata superiore del rettangolo di origine.

pWidth

Puntatore alla larghezza del rettangolo di origine.

pHeight

Puntatore all'altezza 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_POINTER
Argomento puntatore NULL.
VFW_E_NOT_CONNECTED
Impossibile eseguire l'operazione perché i pin non sono connessi.
NOERROR
Operazione completata.

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