Interfaccia IBasicVideo (control.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.

L'interfaccia IBasicVideo imposta proprietà video, ad esempio i rettangoli di destinazione e di origine. I filtri Del renderer video e del rendering video implementano questa interfaccia, ma l'interfaccia viene esposta alle applicazioni tramite Filter Graph Manager. Le applicazioni devono sempre recuperare questa interfaccia da Filter Graph Manager.

L'interfaccia IBasicVideo modifica i rettangoli seguenti associati all'immagine video:

  • Il rettangolo di origine è la parte dell'immagine originale visualizzata.
  • Il rettangolo di destinazione è la parte della finestra video che riceve il rettangolo di origine.
  • Il rettangolo video è l'immagine video originale.
In altre parole, il renderer video ritaglia l'immagine nel rettangolo di origine e quindi estende o compatta l'immagine ritagliata nel rettangolo di destinazione. Tutte le dimensioni del rettangolo vengono specificate in pixel.

Le proprietà impostate sul Renderer video vengono mantenute tra connessioni successive e disconnessioni.

Codici di errore: se il filtro del renderer video non è connesso a un altro filtro, tutti i metodi restituiscono il codice di errore VFW_E_NOT_CONNECTED. Per l'implementazione di Filter Graph Manager, se il grafico non contiene un filtro del renderer video, tutti i metodi restituiscono E_NOINTERFACE. Si noti che Filter Graph Manager espone l'interfaccia anche quando il grafico non contiene un renderer video, in modo che un'applicazione possa eseguire query per l'interfaccia prima di compilare il grafico.

Ereditarietà

L'interfaccia IBasicVideo eredita dall'interfaccia IDispatch . IBasicVideo include anche questi tipi di membri:

Metodi

L'interfaccia IBasicVideo include questi metodi.

 
IBasicVideo::get_AvgTimePerFrame

Il metodo get_AvgTimePerFrame recupera il tempo medio tra fotogrammi successivi.
IBasicVideo::get_BitErrorRate

Il metodo get_BitErrorRate recupera la frequenza di errore di bit approssimativa del flusso video.
IBasicVideo::get_BitRate

Il metodo get_BitRate recupera la frequenza di bit approssimativa del flusso video.
IBasicVideo::get_DestinationHeight

Il metodo get_DestinationHeight recupera l'altezza del rettangolo di destinazione.
IBasicVideo::get_DestinationLeft

Il metodo get_DestinationLeft recupera la coordinata x del rettangolo di destinazione.
IBasicVideo::get_DestinationTop

Il metodo get_DestinationTop recupera la coordinata y del rettangolo di destinazione.
IBasicVideo::get_DestinationWidth

Il metodo get_DestinationWidth recupera la larghezza del rettangolo di destinazione.
IBasicVideo::get_SourceHeight

Il metodo get_SourceHeight recupera l'altezza del rettangolo di origine.
IBasicVideo::get_SourceLeft

Il metodo get_SourceLeft recupera la coordinata x del rettangolo di origine.
IBasicVideo::get_SourceTop

Il metodo get_SourceTop recupera la coordinata y del rettangolo di origine.
IBasicVideo::get_SourceWidth

Il metodo get_SourceWidth recupera la larghezza del rettangolo di origine.
IBasicVideo::get_VideoHeight

Il metodo get_VideoHeight recupera l'altezza nativa del video.
IBasicVideo::get_VideoWidth

Il metodo get_VideoWidth recupera la larghezza nativa del video.
IBasicVideo::GetCurrentImage

Il metodo GetCurrentImage recupera l'immagine corrente in attesa del renderer.
IBasicVideo::GetDestinationPosition

Il metodo GetDestinationPosition recupera la posizione del rettangolo di destinazione.
IBasicVideo::GetSourcePosition

Il metodo GetSourcePosition recupera la posizione del rettangolo di origine.
IBasicVideo::GetVideoPaletteEntries

Il metodo GetVideoPaletteEntries recupera i colori della tavolozza per il video.
IBasicVideo::GetVideoSize

Il metodo GetVideoSize recupera le dimensioni video native.
IBasicVideo::IsUsingDefaultDestination

Il metodo IsUsingDefaultDestination esegue una query se il renderer usa il rettangolo di destinazione predefinito.
IBasicVideo::IsUsingDefaultSource

Il metodo IsUsingDefaultSource esegue una query se il renderer usa il rettangolo di origine predefinito.
IBasicVideo::p ut_DestinationHeight

Il metodo put_DestinationHeight imposta l'altezza del rettangolo di destinazione.
IBasicVideo::p ut_DestinationLeft

Il metodo put_DestinationLeft imposta la coordinata x del rettangolo di destinazione.
IBasicVideo::p ut_DestinationTop

Il metodo put_DestinationTop imposta la coordinata y del rettangolo di destinazione.
IBasicVideo::p ut_DestinationWidth

Il metodo put_DestinationWidth imposta la larghezza del rettangolo di destinazione.
IBasicVideo::p ut_SourceHeight

Il metodo put_SourceHeight imposta l'altezza del rettangolo di origine.
IBasicVideo::p ut_SourceLeft

Il metodo put_SourceLeft imposta la coordinata x del rettangolo di origine.
IBasicVideo::p ut_SourceTop

Il metodo put_SourceTop imposta la coordinata y del rettangolo di origine.
IBasicVideo::p ut_SourceWidth

Il metodo put_SourceWidth imposta la larghezza del rettangolo di origine.
IBasicVideo::SetDefaultDestinationPosition

Il metodo SetDefaultDestinationPosition viene ripristinato nel rettangolo di destinazione predefinito. Dopo aver chiamato questo metodo, il renderer video usa l'intera finestra per la riproduzione.
IBasicVideo::SetDefaultSourcePosition

Il metodo SetDefaultSourcePosition viene ripristinato nel rettangolo di origine predefinito. Dopo aver chiamato questo metodo, il renderer video usa l'intera immagine video, senza ritagliare.
IBasicVideo::SetDestinationPosition

Il metodo SetDestinationPosition imposta il rettangolo di destinazione.
IBasicVideo::SetSourcePosition

Il metodo SetSourcePosition imposta il rettangolo di origine.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione control.h (includere Dshow.h)

Vedi anche

Idispatch