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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |