Freigeben über


IBasicVideo-Schnittstelle (control.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die IBasicVideo Schnittstelle legt Videoeigenschaften fest, z. B. die Ziel- und Quellrechtecke. Die Filter Video Renderer und Video Mixing Renderer implementieren diese Schnittstelle, aber die Schnittstelle wird anwendungen über den Filter Graph-Manager verfügbar gemacht. Anwendungen sollten diese Schnittstelle immer aus dem Filter Graph-Manager abrufen.

Die IBasicVideo Schnittstelle bearbeitet die folgenden Rechtecke, die dem Videobild zugeordnet sind:

  • Das Quellrechteck ist der Teil des ursprünglichen Bilds, der angezeigt wird.
  • Das Zielrechteck ist der Teil des Videofensters, das das Quellrechteck empfängt.
  • Das Videorechteck ist das ursprüngliche Videobild.
Anders ausgedrückt: Der Videorenderer schneidet das Bild auf das Quellrechteck zu und dehnt dann das zugeschnittene Bild bis zum Zielrechteck. Alle Rechteckdimensionen werden in Pixeln angegeben.

Eigenschaften, die für den Video Renderer festgelegt sind, bleiben zwischen aufeinander folgenden Verbindungen und Trennungen erhalten.

Fehlercodes: Wenn der Videorendererfilter nicht mit einem anderen Filter verbunden ist, geben alle Methoden den Fehlercode VFW_E_NOT_CONNECTED zurück. Wenn das Diagramm für die Implementierung des Filter Graph-Managers keinen Videorendererfilter enthält, geben alle Methoden E_NOINTERFACE zurück. Beachten Sie, dass der Filter Graph-Manager die Schnittstelle auch dann verfügbar macht, wenn der Graph keinen Videorenderer enthält, sodass eine Anwendung die Schnittstelle abfragen kann, bevor sie den Graph erstellt.

Vererbung

Die IBasicVideo-Schnittstelle erbt von der IDispatch-Schnittstelle . IBasicVideo verfügt auch über folgende Arten von Membern:

Methoden

Die IBasicVideo-Schnittstelle verfügt über diese Methoden.

 
IBasicVideo::get_AvgTimePerFrame

Die get_AvgTimePerFrame-Methode ruft die durchschnittliche Zeit zwischen aufeinander folgenden Frames ab.
IBasicVideo::get_BitErrorRate

Die get_BitErrorRate-Methode ruft die ungefähre Bitfehlerrate des Videodatenstroms ab.
IBasicVideo::get_BitRate

Die get_BitRate-Methode ruft die ungefähre Bitrate des Videodatenstroms ab.
IBasicVideo::get_DestinationHeight

Die get_DestinationHeight-Methode ruft die Höhe des Zielrechtecks ab.
IBasicVideo::get_DestinationLeft

Die get_DestinationLeft-Methode ruft die x-Koordinate des Zielrechtecks ab.
IBasicVideo::get_DestinationTop

Die get_DestinationTop-Methode ruft die y-Koordinate des Zielrechtecks ab.
IBasicVideo::get_DestinationWidth

Die get_DestinationWidth-Methode ruft die Breite des Zielrechtecks ab.
IBasicVideo::get_SourceHeight

Die get_SourceHeight-Methode ruft die Höhe des Quellrechtecks ab.
IBasicVideo::get_SourceLeft

Die get_SourceLeft-Methode ruft die x-Koordinate des Quellrechtecks ab.
IBasicVideo::get_SourceTop

Die get_SourceTop-Methode ruft die y-Koordinate des Quellrechtecks ab.
IBasicVideo::get_SourceWidth

Die get_SourceWidth-Methode ruft die Breite des Quellrechtecks ab.
IBasicVideo::get_VideoHeight

Die get_VideoHeight-Methode ruft die native Höhe des Videos ab.
IBasicVideo::get_VideoWidth

Die get_VideoWidth-Methode ruft die native Breite des Videos ab.
IBasicVideo::GetCurrentImage

Die GetCurrentImage-Methode ruft das aktuelle Bild ab, das auf den Renderer wartet.
IBasicVideo::GetDestinationPosition

Die GetDestinationPosition-Methode ruft die Position des Zielrechtecks ab.
IBasicVideo::GetSourcePosition

Die GetSourcePosition-Methode ruft die Position des Quellrechtecks ab.
IBasicVideo::GetVideoPaletteEntries

Die GetVideoPaletteEntries-Methode ruft die Palettenfarben für das Video ab.
IBasicVideo::GetVideoSize

Die GetVideoSize-Methode ruft die nativen Videodimensionen ab.
IBasicVideo::IsUsingDefaultDestination

Die IsUsingDefaultDestination-Methode fragt ab, ob der Renderer das Standardzielrechteck verwendet.
IBasicVideo::IsUsingDefaultSource

Die IsUsingDefaultSource-Methode fragt ab, ob der Renderer das Standardquellrechteck verwendet.
IBasicVideo::p ut_DestinationHeight

Die put_DestinationHeight-Methode legt die Höhe des Zielrechtecks fest.
IBasicVideo::p ut_DestinationLeft

Die put_DestinationLeft-Methode legt die x-Koordinate des Zielrechtecks fest.
IBasicVideo::p ut_DestinationTop

Die put_DestinationTop-Methode legt die y-Koordinate des Zielrechtecks fest.
IBasicVideo::p ut_DestinationWidth

Die put_DestinationWidth-Methode legt die Breite des Zielrechtecks fest.
IBasicVideo::p ut_SourceHeight

Die put_SourceHeight-Methode legt die Höhe des Quellrechtecks fest.
IBasicVideo::p ut_SourceLeft

Die put_SourceLeft-Methode legt die x-Koordinate des Quellrechtecks fest.
IBasicVideo::p ut_SourceTop

Die put_SourceTop-Methode legt die y-Koordinate des Quellrechtecks fest.
IBasicVideo::p ut_SourceWidth

Die put_SourceWidth-Methode legt die Breite des Quellrechtecks fest.
IBasicVideo::SetDefaultDestinationPosition

Die SetDefaultDestinationPosition-Methode wird auf das Standardzielrechteck zurückgesetzt. Nachdem diese Methode aufgerufen wurde, verwendet der Videorenderer das gesamte Fenster für die Wiedergabe.
IBasicVideo::SetDefaultSourcePosition

Die SetDefaultSourcePosition-Methode wird auf das Standardquellrechteck zurückgesetzt. Nachdem diese Methode aufgerufen wurde, verwendet der Videorenderer das gesamte Videobild, ohne zuzuschneiden.
IBasicVideo::SetDestinationPosition

Die SetDestinationPosition-Methode legt das Zielrechteck fest.
IBasicVideo::SetSourcePosition

Die SetSourcePosition-Methode legt das Quellrechteck fest.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile control.h (include Dshow.h)

Weitere Informationen

IDispatch