IRenderEngine-Schnittstelle
[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.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Die IRenderEngine Schnittstelle rendert ein DirectShow Editing Services (DES)-Projekt, indem ein Filterdiagramm aus einem Zeitleiste erstellt wird.
DES stellt zwei Komponenten bereit, die diese Schnittstelle implementieren:
- Die einfache Render-Engine erstellt eine unkomprimierte Ausgabe. Sie können die Ausgabe für die Vorschau verwenden oder sie über Komprimierungsfilter weiterleiten und in eine Datei schreiben.
- Die Intelligente Render-Engine erstellt eine komprimierte Ausgabe mithilfe der intelligenten Neukomprimierung. Bei der intelligenten Neukomprimierung wird eine Quelldatei nur dann erneut komprimiert, wenn sich ihr Format vom Ausgabeformat unterscheidet. Eine Quelle mit einem übereinstimmenden Format wird direkt in die Ausgabedatei geschrieben. Je nach Szenario kann die intelligente Neukomprimierung die Renderingzeit erheblich verbessern.
Die Smart Render Engine unterstützt auch die ISmartRenderEngine-Schnittstelle .
Obwohl eine Anwendung ein Filterdiagramm erstellen und an eine Render-Engine übergeben kann, besteht das typische Szenario darin, dass die Render-Engine das Filterdiagramm erstellt. Das Erstellen des Graphen ist ein zweistufiger Prozess. Erstellen Sie zunächst das Front-End, indem Sie die IRenderEngine::ConnectFrontEnd-Methode aufrufen. Verbinden Sie dann die Ausgabepins am Front-End mit den gewünschten Renderingfiltern:
- Video- und Audiorenderer für die Vorschau oder
- Kompressoren, Multiplexer und Dateischreiber, um die endgültige Ausgabe zu generieren.
Member
Die IRenderEngine-Schnittstelle erbt von der IUnknown-Schnittstelle . IRenderEngine verfügt auch über folgende Arten von Membern:
Methoden
Die IRenderEngine-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| Commit | Nicht implementiert. |
| ConnectFrontEnd | Erstellt das Front-End des Filterdiagramms aus dem aktuellen Zeitleiste. |
| Aufheben der Aussetzung | Nicht implementiert. |
| DoSmartRecompression | Wird nicht unterstützt. |
| GetCaps | Nicht implementiert. |
| GetFilterGraph | Ruft das Filterdiagramm ab, das die Render-Engine erstellt hat, falls vorhanden. |
| GetGroupOutputPin | Ruft den Ausgabenadel für die angegebene Gruppe ab. |
| GetTimelineObject | Ruft die Zeitleiste ab, die die Render-Engine derzeit verwendet. |
| GetVendorString | Ruft die Anbieterzeichenfolge ab. |
| RenderOutputPins | Erstellt den Vorschauteil des Filterdiagramms. |
| ScrapIt | Verwirft das Filterdiagramm der Render-Engine und alle zugehörigen Objekte. |
| SetDynamicReconnectLevel | Legt die Ebene der dynamischen Wiederverbindung während des Renderings fest. |
| SetFilterGraph | Gibt ein Filterdiagramm an, das die Render-Engine verwenden soll. |
| SetInterestRange | Wird nicht unterstützt. |
| SetInterestRange2 | Wird nicht unterstützt. |
| SetRenderRange | Legt den Zeitbereich fest, der gerendert werden soll. |
| SetRenderRange2 | Legt den zeitraum fest, der gerendert werden soll, als double. |
| SetSourceConnectCallback | Wird nicht unterstützt. |
| SetSourceNameValidation | Gibt an, wie die Render-Engine Dateinamen überprüft. |
| SetTimelineObject | Legt den Zeitleiste fest, den die Render-Engine verwenden soll. |
| UseInSmartRecompressionGraph | Wird nicht unterstützt. |
Bemerkungen
Hinweis
Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.
Hinweis
Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch