Compartir a través de

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

  • Artículo

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

Nota La interfaz ICaptureGraphBuilder está en desuso. Use ICaptureGraphBuilder2 en su lugar.
 
Crea la sección de representación del grafo de filtro, que guardará bits en el disco con el nombre de archivo especificado.

Sintaxis

HRESULT SetOutputFileName(
  [in]  const GUID      *pType,
  [in]  LPCOLESTR       lpstrFile,
  [out] IBaseFilter     **ppf,
  [out] IFileSinkFilter **ppSink
);

Parámetros

[in] pType

Puntero a un GUID que representa el subtipo multimedia. Debe ser &MEDIASUBTYPE_Avi.

[in] lpstrFile

Puntero a una cadena de caracteres anchos que contiene el nombre del archivo de salida.

[out] ppf

Dirección de un puntero a una interfaz IBaseFilter que representa el filtro de multiplexador. Este método incrementa el recuento de referencias en la interfaz IBaseFilter , por lo que debe disminuir el recuento de referencias mediante el método Release en este parámetro cuando haya terminado con el filtro.

[out] ppSink

Dirección de un puntero a una interfaz IFileSinkFilter que representa el escritor de archivos. Este método incrementa el recuento de referencias en la interfaz IFileSinkFilter, por lo que debe disminuir el recuento de referencias mediante Release cuando haya terminado con el filtro.

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto Descripción
E_FAIL
 Error.
E_INVALIDARG
 Argumento no válido. Audio-Video Interleaved (AVI) es el único formato de salida admitido.
E_OUTOFMEMORY
 Memoria insuficiente
E_POINTER
 Argumento de puntero NULL.
E_UNEXPECTED
 Se ha producido un error inesperado.
NOERROR
 Correcto.
S_OK
 Se creó correctamente la instancia del filtro multiplexador AVI.

Comentarios

Este método inserta el multiplexador y el escritor de archivos en el gráfico de filtros y llama a IFileSinkFilter::SetFileName para establecer el nombre del archivo de salida.

Puede usar el parámetro ppf devuelto por este método como parámetro pfRenderer en llamadas a RenderStream.

Puede usar el parámetro pSink de este método en una llamada a SetFileName para cambiar el nombre de archivo establecido por ICaptureGraphBuilder::SetOutputFileName.

Requisitos

Requisito Value
Cliente mínimo compatible Reference:_Dshowh
Plataforma de destino Windows
Encabezado strmif.h
Archivo DLL Quartz.dll

Consulte también

Códigos de error y éxito

ICaptureGraphBuilder (interfaz)