IMediaFilter::Run-Methode (strmif.h)
[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.]
Die Run -Methode führt den Filter aus.
Syntax
HRESULT Run(
REFERENCE_TIME tStart
);
Parameter
tStart
Referenzzeit, die der Streamzeit 0 entspricht.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Übergang ist nicht abgeschlossen. |
|
Erfolg. Der Übergang ist abgeschlossen. |
Hinweise
Wenn ein Filter ausgeführt wird, kann er Beispiele empfangen, verarbeiten und übermitteln. Quellfilter generieren neue Beispiele, und Rendererfilter rendern sie.
Der Zustandsübergang kann asynchron sein. Wenn die Methode vor Abschluss des Übergangs zurückgibt, wird der Rückgabewert S_FALSE.
Stream Zeit wird als aktuelle Referenzzeit abzüglich tStart berechnet. Um zu berechnen, wann ein Medienbeispiel gerendert werden soll, vergleicht der Renderer den Zeitstempel mit der aktuellen Streamzeit. Daher sollte ein Medienbeispiel mit einem Zeitstempel von null zum Zeitpunkt tStart gerendert werden. Weitere Informationen finden Sie unter Zeit und Uhren in DirectShow.
Wenn eine Anwendung die IMediaControl::Run-Methode aufruft, ruft IMediaFilter::Run der Filter Graph Manager für jeden Filter auf. Er legt den Wert von tStart in zukunft geringfügig fest, um die Graphlatenz zu berücksichtigen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |