Beispielgrabberfilter
[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.]
Der Filter Sample Grabber bietet eine Möglichkeit zum Abrufen von Beispielen, während sie das Filterdiagramm durchlaufen. Es handelt sich um einen Transformationsfilter mit einem Eingabenadel und einem Ausgabestift. Es übergibt alle Stichproben nach dem Downstream unverändert, sodass Sie sie in ein Filterdiagramm einfügen können, ohne den Datenstrom zu ändern. Ihre Anwendung kann dann einzelne Beispiele aus dem Filter abrufen, indem sie Methoden auf der ISampleGrabber-Schnittstelle aufruft.
Wenn Sie Beispiele abrufen möchten, ohne die Daten zu rendern, verbinden Sie den Filter Sample Grabber mit dem Filter Null Renderer .
| Bezeichnung | Wert |
|---|---|
| Filterschnittstellen | IBaseFilter, ISampleGrabber |
| Eingabenadelmedientypen | Beliebiger Medientyp. |
| Eingabenadelschnittstellen | IMemInputPin, IPin, IQualityControl |
| Ausgabeheftmedientypen | Beliebiger Medientyp. Entspricht dem Eingabemedientyp. |
| Ausgabepinschnittstellen | IMediaPosition, IMediaSeeking, IPin, IQualityControl |
| Filtern von CLSID | CLSID_SampleGrabber |
| Eigenschaftenseite CLSID | Keine Eigenschaftenseite. |
| Ausführbare Datei | Qedit.dll |
| Verdienst | MERIT_DO_NOT_USE |
| Filterkategorie | CLSID_LegacyAmFilterCategory |
Bemerkungen
Um diesen Filter zu verwenden, fügen Sie ihn dem Filterdiagramm hinzu, und rufen Sie ISampleGrabber::SetMediaType mit dem gewünschten Medientyp auf. Diese Methode gibt den Medientyp für die Eingabe- und Ausgabe-Pinverbindungen des Filters an. Verbinden Sie dann den Filter mit anderen Filtern im Diagramm.
Wenn Sie ISampleGrabber::SetBufferSamples mit dem Wert TRUE aufrufen, puffert der Filter jedes empfangene Beispiel, bevor er es downstream übergibt. Rufen Sie die ISampleGrabber::GetCurrentBuffer-Methode auf, um den aktuellen Inhalt des Puffers abzurufen. Alternativ können Sie ISampleGrabber::SetCallback aufrufen, damit der Filter bei jedem Empfang eines Beispiels eine Rückruffunktion aufruft.
Für den Filter gelten die folgenden Einschränkungen für Videoformate:
- Videotypen mit top-down-Ausrichtung (negative biHeight) werden nicht unterstützt.
- Die VIDEOINFOHEADER2-Formatstruktur (Formattyp gleich FORMAT_VideoInfo2) wird nicht unterstützt.
- Es lehnt jeden Videotyp ab, bei dem die Fläche nicht mit der Videobreite übereinstimmt.
Daher stellt der Beispielgrabber für einige Videotypen keine Verbindung mit dem Videomischungsrenderer (Video Mixing Renderer, VMR) her.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
Siehe auch