Metodo ICaptureGraphBuilder2::AllocCapFile (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il AllocCapFile metodo prealloca un file di acquisizione in una dimensione specificata. Per ottenere risultati ottimali, acquisire sempre in un file di acquisizione preallocato preallocato maggiore delle dimensioni dei dati di acquisizione.

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 del file da allocare, in byte.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo ha esito negativo se il file è di sola lettura.

È consigliabile allocare il più possibile spazio, idealmente, più che necessario. Tuttavia, questo può comportare un file molto grande che contiene dati relativamente piccoli. Ad esempio, un file di acquisizione da 1 gigabyte (GB) potrebbe contenere alcuni megabyte di video acquisiti. Usare il metodo ICaptureGraphBuilder2::CopyCaptureFile per copiare i dati in un nuovo file. Questo metodo copia solo i dati e ignora la parte vuota del file originale.

Se si usa questo metodo per preallocare il file, chiamare IFileSinkFilter2::SetMode nel filtro del file-writer con il valore zero. Se il filtro è impostato su AM_FILE_OVERWRITE, eliminerà il file preallocato. Si noti che alcuni filtri del writer di file non supportano la modalità 0.

Requisiti

Vedi anche

Codici errore e esito positivo

Interfaccia ICaptureGraphBuilder2