CBaseControlVideo-Klasse
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]
Die CBaseControlVideo-Klasse implementiert die IBasicVideo-Schnittstelle und steuert die Videoeigenschaften eines generischen Videofensters. Im Allgemeinen ist ein CBaseControlVideo-Objekt ein Videorenderer, der Videos in ein Fenster auf dem Display zeichnet.
Viele CBaseControlVideo-Memberfunktionen erfordern nur, dass der Videorenderer mit einem Filterdiagramm verbunden ist. Wenn sie nicht verbunden ist, geben Memberfunktionen VFW_E_NOT_CONNECTED zurück. Für einen Videorenderer festgelegte Eigenschaften bleiben zwischen aufeinander folgenden Verbindungen und Trennungen erhalten. Alle Anwendungen sollten sicherstellen, dass sie die Renderereigenschaften zurücksetzen, bevor sie eine Präsentation starten.
Beim Arbeiten mit Video kann die Anwendung einen Teil des zu verwendenden Videos auswählen. Dieser Teil ist das Quellrechteck, das das CBaseControlVideo-Objekt steuert. Mit CBaseControlVideo kann Ihre Anwendung das Quellrechteck festlegen und abrufen. Alle Rechtecke, die CBaseControlVideo verwendet, verwenden Breiten- und Höhenwerte anstelle von rechten und unteren Werten. Wenn kein Quellrechteck festgelegt wurde, geben die Eigenschaften des Quellrechtecks die vollständige, native Videogröße zurück.
Geschützte Datenmember | BESCHREIBUNG |
---|---|
m_pFilter | Zeiger auf einen eigenen Medienfilter. |
m_pInterfaceLock | Extern definierter kritischer Abschnitt. |
m_pPin | Steuern der Medientypen für die Verbindung. |
Elementfunktionen | BESCHREIBUNG |
CBaseControlVideo | Erstellt ein CBaseControlVideo-Objekt . |
CopyImage | Erstellt eine Speicherkopie eines Videobilds. |
GetImageSize | Ruft Videobildgrößeninformationen ab. |
SetControlVideoPin | Legt den Pin fest, mit dem dieses Objekt synchronisiert werden soll. |
Überschreibbare Memberfunktionen | BESCHREIBUNG |
CheckSourceRect | Bestimmt, ob ein Quellrechteck gültig ist. |
CheckTargetRect | Bestimmt, ob ein Zielrechteck gültig ist. |
GetSourceRect | Ruft das aktuelle Quellvideorechteck (rein virtuell) ab. |
GetStaticImage | Gibt das aktuelle Image in einem Speicherpuffer (rein virtuell) zurück. |
GetTargetRect | Ruft das aktuelle Zielvideorechteck (rein virtuell) ab. |
GetVideoFormat | Ruft die VIDEOINFOHEADER-Struktur ab, die das Videoformat enthält. |
IsDefaultSourceRect | Bestimmt, ob der Renderer das Standardquellrechteck (rein virtuell) verwendet. |
IsDefaultTargetRect | Bestimmt, ob der Renderer das Standardzielrechteck (rein virtuell) verwendet. |
OnUpdateRectangles | Wird aufgerufen, wenn sich das Quell- oder Zielrechteck ändert. |
OnVideoSizeChange | Übergibt EC_VIDEO_SIZE_CHANGED an die Anwendung. |
SetDefaultSourceRect | Legt das Standardquell-Videorechteck (rein virtuell) fest. |
SetDefaultTargetRect | Legt das Standardziel-Videorechteck (rein virtuell) fest. |
SetSourceRect | Legt das aktuelle Quellvideorechteck (rein virtuell) fest. |
SetTargetRect | Legt das aktuelle Zielrechteck (rein virtuell) fest. |
IBasicVideo-Methoden | BESCHREIBUNG |
get_AvgTimePerFrame | Ruft eine ungefähre durchschnittliche Zeit pro Frame ab. |
get_BitErrorRate | Ruft eine ungefähre Bitfehlerrate ab. |
get_BitRate | Ruft eine ungefähre Bitrate für das Video ab. |
GetCurrentImage | Ruft ein Speicherrendering des aktuellen Bilds ab. |
get_DestinationHeight | Ruft die Höhe des aktuellen Zielrechtecks ab. |
get_DestinationLeft | Ruft die linke Koordinate des aktuellen Zielrechtecks ab. |
GetDestinationPosition | Ruft die aktuelle Zielposition ab. |
get_DestinationTop | Ruft die oberste Koordinate des aktuellen Zielrechtecks ab. |
get_DestinationWidth | Ruft die Breite des aktuellen Zielrechtecks ab. |
get_SourceHeight | Ruft die Höhe des aktuellen Quellrechtecks ab. |
get_SourceLeft | Ruft die linke Koordinate des aktuellen Quellrechtecks ab. |
GetSourcePosition | Ruft die aktuelle Quellposition ab. |
get_SourceTop | Ruft die oberste Koordinate des aktuellen Quellrechtecks ab. |
get_SourceWidth | Ruft die Breite des aktuellen Quellrechtecks ab. |
get_VideoHeight | Ruft die native Videohöhe ab. |
GetVideoPaletteEntries | Ruft einen Bereich von Paletteneinträgen für das Video ab. |
GetVideoSize | Ruft die Breite und Höhe des nativen Videos ab. |
get_VideoWidth | Ruft die native Videobreite ab. |
IsUsingDefaultDestination | Bestimmt, ob der Renderer das Standardzielfenster verwendet. |
IsUsingDefaultSource | Bestimmt, ob der Renderer das Standardquellenfenster verwendet. |
put_DestinationHeight | Legt die Höhe des Zielrechtecks fest. |
put_DestinationLeft | Legt die linke Koordinate des Zielrechtecks fest. |
put_DestinationTop | Legt die oberste Koordinate des Zielrechtecks fest. |
put_DestinationWidth | Legt die Breite des Zielrechtecks fest. |
put_SourceHeight | Legt die Höhe des Quellrechtecks fest. |
put_SourceLeft | Legt die linke Koordinate des Quellrechtecks fest. |
put_SourceTop | Legt die oberste Koordinate des Quellrechtecks fest. |
put_SourceWidth | Legt die Breite des Quellrechtecks fest. |
SetDefaultDestinationPosition | Legt die Standardzielposition erneut fest. |
SetDefaultSourcePosition | Legt die Standardquellposition erneut fest. |
SetDestinationPosition | Legt die Position des Zielrechtecks fest. |
SetSourcePosition | Legt die Position des Quellrechtecks fest. |
Siehe auch