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