Classe CBaseControlVideo
[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.
La classe CBaseControlVideo implementa l'interfaccia IBasicVideo e controlla le proprietà video di una finestra video generica. In genere, un oggetto CBaseControlVideo è un renderer video che disegna video in una finestra sullo schermo.
Molte funzioni membro CBaseControlVideo richiedono solo che il renderer video sia connesso a un grafico di filtro. Se non è connesso, le funzioni membro restituiranno VFW_E_NOT_CONNECTED. Le proprietà impostate su un renderer video persistono tra connessioni successive e disconnessioni. Tutte le applicazioni devono assicurarsi di reimpostare le proprietà del renderer prima di avviare una presentazione.
Quando si lavora con il video, l'applicazione può selezionare una parte del video da usare. Questa parte è il rettangolo di origine che l'oggetto CBaseControlVideo controlla. CBaseControlVideo consente all'applicazione di impostare e recuperare il rettangolo di origine. Tutti i rettangoli usati da CBaseControlVideo usano valori di larghezza e altezza anziché valori destro e inferiore. Quando non è stato impostato alcun rettangolo di origine, le proprietà del rettangolo di origine restituiscono le dimensioni video complete e native.
| Membri dati protetti | Descrizione |
|---|---|
| m_pFilter | Puntatore a un filtro multimediale proprietario. |
| m_pInterfaceLock | Sezione critica definita esternamente. |
| m_pPin | Controllo dei tipi di supporti per la connessione. |
| Funzioni di membro | Descrizione |
| CBaseControlVideo | Costruisce un oggetto CBaseControlVideo . |
| CopyImage | Crea una copia di memoria di un'immagine video. |
| GetImageSize | Recupera le informazioni sulle dimensioni dell'immagine video. |
| SetControlVideoPin | Imposta il pin con cui l'oggetto deve essere sincronizzato. |
| Funzioni membro sostituibile | Descrizione |
| CheckSourceRect | Determina se un rettangolo di origine è valido. |
| CheckTargetRect | Determina se un rettangolo di destinazione è valido. |
| GetSourceRect | Recupera il rettangolo video di origine corrente (virtuale puro). |
| GetStaticImage | Restituisce l'immagine corrente in un buffer di memoria (virtuale puro). |
| GetTargetRect | Recupera il rettangolo video di destinazione corrente (virtuale puro). |
| GetVideoFormat | Recupera la struttura VIDEOINFOHEADER contenente il formato video. |
| IsDefaultSourceRect | Determina se il renderer usa il rettangolo di origine predefinito (virtuale puro). |
| IsDefaultTargetRect | Determina se il renderer usa il rettangolo di destinazione predefinito (virtuale puro). |
| OnUpdateRectangles | Chiamato quando cambia il rettangolo di origine o di destinazione. |
| OnVideoSizeChange | Passa EC_VIDEO_SIZE_CHANGED all'applicazione. |
| SetDefaultSourceRect | Imposta il rettangolo video di origine predefinito (virtuale puro). |
| SetDefaultTargetRect | Imposta il rettangolo video di destinazione predefinito (virtuale puro). |
| SetSourceRect | Imposta il rettangolo video di origine corrente (virtuale puro). |
| SetTargetRect | Imposta il rettangolo di destinazione corrente (virtuale puro). |
| Metodi IBasicVideo | Descrizione |
| get_AvgTimePerFrame | Recupera un tempo medio approssimativo per intervallo. |
| get_BitErrorRate | Recupera una frequenza di errore di bit approssimativa. |
| get_BitRate | Recupera una frequenza di bit approssimativa per il video. |
| GetCurrentImage | Recupera un rendering di memoria dell'immagine corrente. |
| get_DestinationHeight | Recupera l'altezza del rettangolo di destinazione corrente. |
| get_DestinationLeft | Recupera la coordinata sinistra del rettangolo di destinazione corrente. |
| GetDestinationPosition | Recupera la posizione di destinazione corrente. |
| get_DestinationTop | Recupera la coordinata superiore del rettangolo di destinazione corrente. |
| get_DestinationWidth | Recupera la larghezza del rettangolo di destinazione corrente. |
| get_SourceHeight | Recupera l'altezza del rettangolo di origine corrente. |
| get_SourceLeft | Recupera la coordinata sinistra del rettangolo di origine corrente. |
| GetSourcePosition | Recupera la posizione di origine corrente. |
| get_SourceTop | Recupera la coordinata superiore del rettangolo di origine corrente. |
| get_SourceWidth | Recupera la larghezza del rettangolo di origine corrente. |
| get_VideoHeight | Recupera l'altezza del video nativo. |
| GetVideoPaletteEntries | Recupera un intervallo di voci di tavolozza per il video. |
| GetVideoSize | Recupera la larghezza e l'altezza del video nativo. |
| get_VideoWidth | Recupera la larghezza del video nativo. |
| IsUsingDefaultDestination | Determina se il renderer usa la finestra di destinazione predefinita. |
| IsUsingDefaultSource | Determina se il renderer usa la finestra di origine predefinita. |
| put_DestinationHeight | Imposta l'altezza del rettangolo di destinazione. |
| put_DestinationLeft | Imposta la coordinata sinistra del rettangolo di destinazione. |
| put_DestinationTop | Imposta la coordinata superiore del rettangolo di destinazione. |
| put_DestinationWidth | Imposta la larghezza del rettangolo di destinazione. |
| put_SourceHeight | Imposta l'altezza del rettangolo di origine. |
| put_SourceLeft | Imposta la coordinata sinistra del rettangolo di origine. |
| put_SourceTop | Imposta la coordinata superiore del rettangolo di origine. |
| put_SourceWidth | Imposta la larghezza del rettangolo di origine. |
| SetDefaultDestinationPosition | Imposta nuovamente la posizione di destinazione predefinita. |
| SetDefaultSourcePosition | Imposta nuovamente la posizione di origine predefinita. |
| SetDestinationPosition | Imposta la posizione del rettangolo di destinazione. |
| SetSourcePosition | Imposta la posizione del rettangolo di origine. |
Vedi anche