IRenderEngine::ConnectFrontEnd-Methode
[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 ConnectFrontEnd Methode erstellt das Front-End des Filterdiagramms aus dem aktuellen Zeitleiste.
Syntax
HRESULT ConnectFrontEnd();
Parameter
Diese Methode hat keine Parameter.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Folgende Rückgabewerte sind möglich:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Der Renderteil des Diagramms wurde gelöscht. |
|
Keine Zeitleiste für diese Render-Engine festgelegt. |
|
Fehler beim Initialisieren des Rendermoduls. |
|
Fehler beim Vorgang, weil das Projekt nicht erfolgreich gerendert wurde. |
|
Unerwarteter Fehler. |
|
Ungültiger Medientyp. |
Bemerkungen
Diese Methode erstellt nicht den Renderingteil des Filterdiagramms. Die Anwendung muss die Ausgabepins am Front-End mit den gewünschten Renderingfiltern verbinden:
- Rufen Sie zur Vorschau die IRenderEngine::RenderOutputPins-Methode auf.
- Um eine Datei auszugeben, rufen Sie IRenderEngine::GetGroupOutputPin auf, um den Ausgabepin für jede Gruppe abzurufen, und verbinden Sie dann die Pins mit einem Multiplexerfilter.
Wenn Sie die einfache Render-Engine verwenden, erzeugen die Ausgabepins am Front-End unkomprimierte Daten. Wenn Sie die Intelligente Render-Engine verwenden, erzeugen die Ausgabepins komprimierte Daten.
Wenn Sie die Zeitleiste ändern, nachdem Sie das Filterdiagramm erstellt haben, müssen Sie erneut aufrufenConnectFrontEnd, um das Front-End neu zu erstellen. Die -Methode behält den Renderingteil des Graphen nach Möglichkeit bei. Wenn Sie jedoch eine Gruppe hinzufügen oder löschen oder die Reihenfolge der Gruppen ändern, wird der Renderingteil gelöscht, ConnectFrontEnd und Ihre Anwendung muss ihn neu erstellen. Wenn die Methode den Renderingteil löscht, gibt sie S_WARN_OUTPUTRESET zurück.
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