Freigeben über


ISmartRenderEngine::GetGroupCompressor-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 GetGroupCompressor -Methode ruft den Komprimierungsfilter für die angegebene Gruppe ab.

Syntax

HRESULT GetGroupCompressor(
   long        Group,
   IBaseFilter **pCompressor
);

Parameter

Gruppe

Nullbasierter Index der Gruppe.

pCompressor

Empfängt einen Zeiger auf die IBaseFilter-Schnittstelle des Komprimierungsfilters. Er empfängt den Wert NULL , wenn kein Komprimierungsfilter vorhanden ist.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Bemerkungen

Verwenden Sie diese Methode, um Eigenschaften für den Komprimierungsfilter festzulegen, z. B. die Key-Frame-Rate. Rufen Sie diese Methode nach dem Aufrufen von IRenderEngine::ConnectFrontEnd, aber vor dem Rendern des Projekts auf. Fragen Sie dann den Ausgabepin des Komprimierungsfilters für die IAMVideoCompression-Schnittstelle ab, die Methoden zum Festlegen von Komprimierungsparametern enthält. Lassen Sie die Schnittstelle los, wenn Sie fertig sind. Wenn Sie nachfolgende Änderungen am Zeitleiste vornehmen, rufen Sie ConnectFrontEnd auf, und rufen Sie dann erneut GetGroupCompressor auf, um die Komprimierungsparameter zurückzusetzen.

Wenn der Wert von *pCompressor bei der Rückgabe ungleich NULL ist, weist die IBaseFilter-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie mit der Verwendung fertig sind.

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
Qedit.h
Bibliothek
Strmiids.lib

Siehe auch

ISmartRenderEngine-Schnittstelle

Fehler- und Erfolgscodes