Método ICaptureGraphBuilder2::CopyCaptureFile (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
El CopyCaptureFile método copia los datos multimedia válidos de un archivo de captura.
Sintaxis
HRESULT CopyCaptureFile(
[in] LPOLESTR lpwstrOld,
[in] LPOLESTR lpwstrNew,
[in] int fAllowEscAbort,
[in] IAMCopyCaptureFileProgress *pCallback
);
Parámetros
[in] lpwstrOld
Puntero a una cadena de caracteres anchos que contiene el nombre del archivo de origen.
[in] lpwstrNew
Puntero a una cadena de caracteres anchos que contiene el nombre del archivo de destino. Los datos válidos se copian en este archivo.
[in] fAllowEscAbort
Valor booleano que especifica si al presionar la tecla ESC se cancela la operación de copia. Si el valor es TRUE y el usuario presiona la tecla ESC, la operación se detiene. Si el valor es FALSE, el método omite la clave ESC.
[in] pCallback
Puntero a una interfaz IAMCopyCaptureFileProgress para mostrar información de progreso o NULL. Vea Comentarios para obtener más información.
Valor devuelto
Devuelve un valor HRESULT . Estos son algunos de los valores posibles.
| Código devuelto | Descripción |
|---|---|
|
El usuario canceló la operación antes de completarla. |
|
Correcto. |
|
Error. |
|
No se pudo abrir el archivo de origen o el archivo de destino. |
|
Memoria insuficiente. |
|
Argumento de puntero NULL. |
Observaciones
Normalmente, primero se capturará en un archivo preasignado grande. Este método copia solo los datos válidos en un archivo nuevo. Como resultado, el nuevo archivo puede ser mucho menor que el archivo original.
Los archivos de origen y destino deben ser archivos AVI. No se admiten otros tipos de archivo.
Para mostrar el progreso de la operación de copia, implemente la interfaz IAMCopyCaptureFileProgress y pase un puntero a la interfaz en el parámetro pCallback . Si pCallback no es NULL, este método llama periódicamente al método IAMCopyCaptureFileProgress::P rogress con un entero entre 0 y 100 que especifica el porcentaje completado.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | strmif.h (incluye Dshow.h) |
| Library | Strmiids.lib |