Metodo ICaptureGraphBuilder::AllocCapFile (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota L'interfaccia ICaptureGraphBuilder è deprecata. Usare invece ICaptureGraphBuilder2 .
 
Prealloca un file di acquisizione in una dimensione specificata.

Sintassi

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

Parametri

[in] lpstr

Puntatore a una stringa di caratteri wide contenente il nome del file da creare o ridimensionare.

[in] dwlSize

Dimensioni, in byte, del file da allocare.

Valore restituito

Restituisce un valore HRESULT .

Commenti

La chiamata avrà esito negativo se il file è di sola lettura. Per ottenere risultati di acquisizione ottimali, acquisire sempre in un file di acquisizione preallocato e deframmentato che supera le dimensioni dei dati di acquisizione.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)

Vedi anche

Codici di errore e di esito positivo

Interfaccia ICaptureGraphBuilder