Método ICaptureGraphBuilder::CopyCaptureFile (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Sintaxe

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

Parâmetros

[in] lpwstrOld

Ponteiro para uma cadeia de caracteres Unicode™ que contém o nome do arquivo de origem.

[in] lpwstrNew

Ponteiro para uma cadeia de caracteres Unicode que contém o nome do arquivo de destino. Os dados válidos são copiados para esse arquivo.

[in] fAllowEscAbort

Valor que indica se pressionar a chave ESC cancelará a operação de cópia. TRUE indica que ele irá; FALSE indica que esse método ignorará esse pressionamento de tecla.

[in] pCallback

O ponteiro opcional para um IAMCopyCaptureFileProgress mostra o progresso (percentual concluído) da operação de cópia.

Retornar valor

Retorna um valor HRESULT .

Comentários

O novo arquivo conterá apenas dados válidos e, portanto, pode ser muito menor do que o arquivo de origem. Normalmente, você sempre capturará para o mesmo arquivo pré-alocado enorme e usará esse método para copiar os dados que deseja salvar de cada captura para um novo arquivo.

Se você especificar pCallback, o método Progress na interface IAMCopyCaptureFileProgress será chamado periodicamente com um inteiro entre 0 e 100 representando o percentual concluído.

Requisitos

Confira também

Códigos de erro e êxito

ICaptureGraphBuilder Interface