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.
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) |