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

DirectShow-Basisklassen