Freigeben über

IAMOpenProgress-Schnittstelle (strmif.h)

  • Artikel

[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.]

Die IAMOpenProgress Schnittstelle meldet den Fortschritt eines Vorgangs zum Öffnen von Dateien und ermöglicht es der Anwendung, den Vorgang abzubrechen.

Filter, die Dateien über ein Netzwerk öffnen, können diese Schnittstelle verfügbar machen. Eine Anwendung kann sie verwenden, um den Status des Downloads abzufragen oder den Download abzubrechen. Wenn das Netzwerk nicht reagiert, kann eine Methode wie IGraphBuilder::RenderFile auf unbestimmte Zeit blockiert werden. Um zu verhindern, dass Ihre Anwendung blockiert, erstellen Sie einen Workerthread, der verwendet IAMOpenProgress , um den Fortschritt zu überwachen. Der Workerthread kann den Vorgang abbrechen, wenn ein vordefiniertes Timeout auftritt oder als Reaktion auf einen Befehl des Benutzers auftritt.

Der Filter Dateiquelle (URL) unterstützt diese Schnittstelle.

Vererbung

Die IAMOpenProgress-Schnittstelle erbt von der IUnknown-Schnittstelle . IAMOpenProgress verfügt auch über folgende Membertypen:

Methoden

Die IAMOpenProgress-Schnittstelle verfügt über diese Methoden.

 
IAMOpenProgress::AbortOperation

Die AbortOperation-Methode bricht den Datei öffnen-Vorgang ab.
IAMOpenProgress::QueryProgress

Die QueryProgress-Methode ruft den Fortschritt des Datei öffnen-Vorgangs ab.

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)