Metodo CBaseControlVideo.GetDestinationPosition

Articolo
07/28/2023

[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 GetDestinationPosition metodo recupera il rettangolo di destinazione in un'operazione atomica.

Sintassi

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

Parametri

pLeft: Puntatore alla coordinata sinistra del rettangolo di destinazione.
pTop: Puntatore alla coordinata superiore del rettangolo di destinazione.
pWidth: Puntatore alla larghezza del rettangolo di destinazione.
pHeight: Puntatore all'altezza 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_POINTER	Argomento puntatore NULL.
VFW_E_NOT_CONNECTED	Impossibile eseguire l'operazione perché i pin non sono connessi.
NOERROR	Operazione completata.

Commenti

Questa funzione membro può essere usata al posto di chiamate separate alle funzioni membro CBaseControlVideo::get_DestinationLeft, CBaseControlVideo::get_DestinationTop, CBaseControlVideo::get_DestinationWidth e CBaseControlVideo ::get_DestinationHeight. 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

Condividi tramite