ICaptureGraphBuilder2::CopyCaptureFile-Methode (strmif.h)

Artikel
07/28/2023

[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 CopyCaptureFile -Methode kopiert die gültigen Mediendaten aus einer Erfassungsdatei.

Syntax

HRESULT CopyCaptureFile(
  [in] LPOLESTR                   lpwstrOld,
  [in] LPOLESTR                   lpwstrNew,
  [in] int                        fAllowEscAbort,
  [in] IAMCopyCaptureFileProgress *pCallback
);

Parameter

[in] lpwstrOld

Zeiger auf eine Breitzeichenzeichenfolge, die den Namen der Quelldatei enthält.

[in] lpwstrNew

Zeiger auf eine Breitzeichenzeichenfolge, die den Namen der Zieldatei enthält. Gültige Daten werden in diese Datei kopiert.

[in] fAllowEscAbort

Boolescher Wert, der angibt, ob das Drücken der ESC-Taste den Kopiervorgang abbricht. Wenn der Wert TRUE ist und der Benutzer die ESC-Taste drückt, wird der Vorgang angehalten. Wenn der Wert FALSE ist, ignoriert die Methode den ESC-Schlüssel.

[in] pCallback

Zeiger auf eine IAMCopyCaptureFileProgress-Schnittstelle zum Anzeigen von Statusinformationen oder NULL. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
S_FALSE	Der Benutzer hat den Vorgang abgebrochen, bevor er abgeschlossen wurde.
S_OK	Erfolg.
E_FAIL	Fehler.
E_INVALIDARG	Die Quell- oder Zieldatei konnte nicht geöffnet werden.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
E_POINTER	NULL-Zeigerargument.

Bemerkungen

In der Regel erfassen Sie zunächst eine große vorab zugeordnete Datei. Diese Methode kopiert nur die gültigen Daten in eine neue Datei. Daher kann die neue Datei viel kleiner sein als die ursprüngliche Datei.

Die Quell- und Zieldateien müssen AVI-Dateien sein. Andere Dateitypen werden nicht unterstützt.

Um den Fortschritt des Kopiervorgangs anzuzeigen, implementieren Sie die IAMCopyCaptureFileProgress-Schnittstelle , und übergeben Sie einen Zeiger auf die Schnittstelle im pCallback-Parameter . Wenn pCallback nicht NULL ist, ruft diese Methode in regelmäßigen Abständen die IAMCopyCaptureFileProgress::P rogress-Methode mit einer ganzen Zahl zwischen 0 und 100 auf, die den Prozentsatz der Fertigstellung angibt.

Anforderungen


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

Siehe auch

Fehler- und Erfolgscodes

ICaptureGraphBuilder2-Schnittstelle

Freigeben über