Método IGraphBuilder::RenderFile (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 RenderFile método crea un gráfico de filtros que representa el archivo especificado.

Sintaxis

HRESULT RenderFile(
  [in] LPCWSTR lpcwstrFile,
  [in] LPCWSTR lpcwstrPlayList
);

Parámetros

[in] lpcwstrFile

Especifica una cadena de caracteres anchos que contiene el nombre de un archivo multimedia.

[in] lpcwstrPlayList

Reservado. Debe ser NULL.

Valor devuelto

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

Código devuelto Descripción
S_OK
Correcto.
VFW_S_AUDIO_NOT_RENDERED
Éxito parcial; el audio no se ha representado.
VFW_S_DUPLICATE_NAME
Éxito; Filter Graph Manager modificó el nombre del filtro para evitar la duplicación.
VFW_S_PARTIAL_RENDER
Algunas de las secuencias de esta película están en un formato no admitido.
VFW_S_VIDEO_NOT_RENDERED
Éxito parcial; algunas de las secuencias de esta película están en un formato no admitido.
E_ABORT
La operación se anuló.
E_FAIL
Error.
E_INVALIDARG
El argumento no es válido.
E_OUTOFMEMORY
Memoria insuficiente.
E_POINTER
Argumento de puntero NULL.
VFW_E_CANNOT_CONNECT
No se encontró ninguna combinación de filtros intermedios para establecer la conexión.
VFW_E_CANNOT_LOAD_SOURCE_FILTER
No se pudo cargar el filtro de origen de este archivo.
VFW_E_CANNOT_RENDER
No se encontró ninguna combinación de filtros para representar la secuencia.
VFW_E_INVALID_FILE_FORMAT
El formato de archivo no es válido.
VFW_E_NOT_FOUND
No se encontró un objeto o un nombre.
VFW_E_UNKNOWN_FILE_TYPE
No se reconoce el tipo de medio de este archivo.
VFW_E_UNSUPPORTED_STREAM
No se puede reproducir el archivo: no se admite el formato .

Comentarios

Si el parámetro lpwstrFile especifica un archivo multimedia, el método crea un gráfico de filtros para la reproducción predeterminada. En primer lugar, agrega un filtro de origen que puede leer el archivo, usando el mismo proceso que el método IGraphBuilder::AddSourceFilter . A continuación, representa los pines de salida en el filtro de origen, agregando filtros intermedios si es necesario. Intenta filtrar en el mismo orden que el método IGraphBuilder::Connect .

Durante el proceso de conexión, el Administrador de gráficos de filtros omite las patillas de los filtros intermedios si el nombre del pin comienza con una tilde (~). Para obtener más información, consulte PIN_INFO.

Tenga en cuenta que el RenderFile método no quita ningún filtro del gráfico. Si llama RenderFile dos veces, la segunda llamada simplemente agrega más filtros al grafo. Al ejecutar el gráfico, ambos orígenes se reproducirán al mismo tiempo.

Ejemplos

En el ejemplo siguiente se representa un archivo AVI para la reproducción predeterminada:

C++
hr = pGraph->RenderFile(L"C:\\Media\\Example.avi", 0);
En el ejemplo siguiente se descarga un archivo AVI a través de HTTP mediante el filtro Origen de archivo (URL):
C++
hr = pGraph->RenderFile(L"http://example.microsoft.com/Example.avi", 0);

Requisitos

Requisito Value
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 (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IGraphBuilder (interfaz)