IRenderEngine::GetGroupOutputPin-Methode
[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.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Die GetGroupOutputPin -Methode ruft den Ausgabepin für die angegebene Gruppe ab.
Syntax
HRESULT GetGroupOutputPin(
long Group,
[out] IPin **ppRenderPin
);
Parameter
-
Gruppe
-
Nullbasierter Index, der die Gruppe angibt.
-
ppRenderPin [out]
-
Empfängt einen Zeiger auf die IPin-Schnittstelle des Ausgabepins.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Gruppe verfügt nicht über einen Ausgabenadel. |
|
Erfolg. |
|
Ungültiges Argument. |
|
Fehler beim Initialisieren des Rendermoduls. |
|
Ungültiger Zeiger. |
|
Fehler beim Vorgang, weil das Projekt nicht erfolgreich gerendert wurde. |
|
Unerwarteter Fehler. |
Bemerkungen
Rufen Sie vor dem Aufrufen dieser Methode IRenderEngine::ConnectFrontEnd auf, um das Front-End des Graphen zu erstellen. Jede Gruppe stellt einen einzelnen Medienstream dar, und das Front-End verfügt über einen entsprechenden Ausgabepin.
Sie können diese Methode verwenden, um den Renderingteil eines Dateischreibgraphen zu erstellen. Verbinden Sie die Ausgabepins mit Multiplexerfiltern und Dateischreiberfiltern. Weitere Informationen finden Sie unter Rendern eines Projekts.
Für die Vorschau müssen Sie diese Methode nicht aufrufen. Rufen Sie einfach ConnectFrontEnd gefolgt von IRenderEngine::RenderOutputPins auf.
Wenn die Methode S_OK zurückgibt, weist die zurückgegebene IPin-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie die Verwendung abgeschlossen haben.
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