ICaptureGraphBuilder2::AllocCapFile-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 AllocCapFile -Methode alloziert eine Erfassungsdatei einer angegebenen Größe vorab. Um optimale Ergebnisse zu erzielen, erfassen Sie immer eine defragmentierte, vorab zugeordnete Erfassungsdatei, die größer als die Größe der Erfassungsdaten ist.

Syntax

HRESULT AllocCapFile(
  [in] LPCOLESTR lpstr,
  [in] DWORDLONG dwlSize
);

Parameter

[in] lpstr

Zeiger auf eine Breitzeichenzeichenfolge, die den Namen der zu erstellenden oder zu ändernden Datei enthält.

[in] dwlSize

Größe der zuzuordnenden Datei in Bytes.

Rückgabewert

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

Hinweise

Diese Methode schlägt fehl, wenn die Datei schreibgeschützt ist.

Es ist am besten, so viel Platz wie möglich zuzuordnen – im Idealfall mehr als benötigt. Dies kann jedoch zu einer sehr großen Datei führen, die relativ wenig Daten enthält. Beispielsweise kann eine Erfassungsdatei mit 1 GIGABYTE (GB) einige Megabytes an aufgezeichnetem Video enthalten. Verwenden Sie die ICaptureGraphBuilder2::CopyCaptureFile-Methode , um die Daten in eine neue Datei zu kopieren. Diese Methode kopiert nur die Daten und ignoriert den leeren Teil der ursprünglichen Datei.

Wenn Sie diese Methode zum Voraballokatieren der Datei verwenden, rufen Sie IFileSinkFilter2::SetMode für den Dateischreiberfilter mit dem Wert null auf. Wenn der Filter auf AM_FILE_OVERWRITE festgelegt ist, löscht er die vorab zugewiesene Datei. Beachten Sie, dass einige Dateischreiberfilter modus 0 nicht unterstützen.

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

Weitere Informationen

Fehler- und Erfolgscodes

ICaptureGraphBuilder2-Schnittstelle