Metodo ICaptureGraphBuilder2::CopyCaptureFile (strmif.h)

Articolo
07/28/2023

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

Il CopyCaptureFile metodo copia i dati multimediali validi da un file di acquisizione.

Sintassi

HRESULT CopyCaptureFile(
  [in] LPOLESTR                   lpwstrOld,
  [in] LPOLESTR                   lpwstrNew,
  [in] int                        fAllowEscAbort,
  [in] IAMCopyCaptureFileProgress *pCallback
);

Parametri

[in] lpwstrOld

Puntatore a una stringa di caratteri wide contenente il nome del file di origine.

[in] lpwstrNew

Puntatore a una stringa di caratteri wide contenente il nome del file di destinazione. I dati validi vengono copiati in questo file.

[in] fAllowEscAbort

Valore booleano che specifica se la pressione del tasto ESC annulla l'operazione di copia. Se il valore è TRUE e l'utente preme il tasto ESC, l'operazione viene interrotta. Se il valore è FALSE, il metodo ignora la chiave ESC.

[in] pCallback

Puntatore a un'interfaccia IAMCopyCaptureFileProgress per visualizzare informazioni sullo stato di avanzamento o NULL. Per ulteriori informazioni, vedere la sezione Osservazioni.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito	Descrizione
S_FALSE	L'utente ha annullato l'operazione prima del completamento.
S_OK	Operazione completata.
E_FAIL	Esito negativo.
E_INVALIDARG	Impossibile aprire il file di origine o il file di destinazione.
E_OUTOFMEMORY	Memoria insufficiente.
E_POINTER	Argomento puntatore NULL.

Commenti

In genere, si acquisirà prima in un file preallocato di grandi dimensioni. Questo metodo copia solo i dati validi in un nuovo file. Di conseguenza, il nuovo file può essere molto più piccolo del file originale.

I file di origine e di destinazione devono essere file AVI. Altri tipi di file non sono supportati.

Per visualizzare lo stato di avanzamento dell'operazione di copia, implementare l'interfaccia IAMCopyCaptureFileProgress e passare un puntatore all'interfaccia nel parametro pCallback . Se pCallback non è NULL, questo metodo chiama periodicamente il metodo IAMCopyCaptureFileProgress::P rogress con un numero intero compreso tra 0 e 100 che specifica la percentuale di completamento.

Requisiti


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

Vedi anche

Codici di errore e di esito positivo

Interfaccia ICaptureGraphBuilder2

Condividi tramite