Metodo ICaptureGraphBuilder::CopyCaptureFile (strmif.h)
[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.
Sintassi
HRESULT CopyCaptureFile(
[in] LPOLESTR lpwstrOld,
[in] LPOLESTR lpwstrNew,
[in] int fAllowEscAbort,
[in] IAMCopyCaptureFileProgress *pCallback
);
Parametri
[in] lpwstrOld
Puntatore a una stringa Unicode™ contenente il nome del file di origine.
[in] lpwstrNew
Puntatore a una stringa Unicode contenente il nome del file di destinazione. I dati validi vengono copiati in questo file.
[in] fAllowEscAbort
Valore che indica se la pressione del tasto ESC annulla l'operazione di copia. TRUE indica che lo farà; FALSE indica che questo metodo ignorerà la sequenza di tasti.
[in] pCallback
Il puntatore facoltativo a un IAMCopyCaptureFileProgress mostra lo stato di avanzamento (percentuale di completamento) dell'operazione di copia.
Valore restituito
Restituisce un valore HRESULT .
Commenti
Il nuovo file conterrà solo dati validi e pertanto può essere molto più breve del file di origine. In genere, si acquisisce sempre nello stesso file preallocato enorme e si usa questo metodo per copiare i dati da salvare da ogni acquisizione in un nuovo file.
Se si specifica pCallback, il metodo Progress nell'interfaccia IAMCopyCaptureFileProgress verrà chiamato periodicamente con un numero intero compreso tra 0 e 100 che rappresenta la percentuale di completamento.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |