ICaptureGraphBuilder::AllocCapFile-Methode (strmif.h)

Artikel
03/02/2024

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

Hinweis Die ICaptureGraphBuilder-Schnittstelle ist veraltet. Verwenden Sie stattdessen ICaptureGraphBuilder2 .

Eine Erfassungsdatei wird einer angegebenen Größe vorab zugeordnet.

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

Gibt einen HRESULT-Wert zurück.

Hinweise

Der Aufruf schlägt fehl, wenn die Datei schreibgeschützt ist. Um optimale Erfassungsergebnisse zu erzielen, erfassen Sie immer in einer defragmentierten, vorab zugeordneten Erfassungsdatei, die größer als die Größe der Erfassungsdaten ist.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)

Weitere Informationen

Fehler- und Erfolgscodes

ICaptureGraphBuilder-Schnittstelle

Freigeben über