IGraphBuilder::RenderFile

This method builds a filter graph that renders the specified file.

HRESULT RenderFile(
  LPCWSTR lpwstrFile,
  LPCWSTR lpwstrPlayList
);

Parameters

  • lpwstrFile
    [in] Name of the file containing the data to be rendered.
  • lpwstrPlayList
    [in] Playlist name. Reserved; must be NULL. (This parameter is currently unimplemented.)

Return Values

Returns an HRESULT value, which can include one of the following error or success codes:

  • VFW_S_AUDIO_NOT_RENDERED
  • VFW_S_DUPLICATE_NAME
  • VFW_S_PARTIAL_RENDER
  • VFW_S_RPZA
  • VFW_S_VIDEO_NOT_RENDERED

Remarks

If the lpwstrPlayList parameter is NULL, this method would use the default playlist, which typically renders the entire file.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IGraphBuilder Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.