Microsoft DirectX 8.1 (C++) |
The RenderFile method builds a filter graph that renders the specified file. This method is intended for use by Visual Basic applications.
Syntax
HRESULT RenderFile(
BSTR strFilename
);
Parameters
strFilename
Name of the file to render.
Return Values
Returns an HRESULT value. Possible values include the following.
Value | Description |
S_OK | Success. |
VFW_S_AUDIO_NOT_RENDERED | Cannot play the audio stream: could not find a suitable renderer. |
VFW_S_DUPLICATE_NAME | An attempt to add a filter with a duplicate name succeeded with a modified name. |
VFW_S_PARTIAL_RENDER | Some streams in this movie are in an unsupported format. |
VFW_S_VIDEO_NOT_RENDERED | Cannot play the video stream: could not find a suitable renderer. |
E_ABORT | Operation aborted. |
VFW_E_CANNOT_CONNECT | No combination of intermediate filters could be found to make the connection. |
VFW_E_CANNOT_LOAD_SOURCE_FILTER | The source filter for this file could not be loaded. |
VFW_E_CANNOT_RENDER | No combination of filters could be found to render the stream. |
VFW_E_INVALID_FILE_FORMAT | The file format is invalid. |
VFW_E_NOT_FOUND | An object or name was not found. |
VFW_E_NOT_IN_GRAPH | Cannot perform the requested function on an object that is not in the filter graph. |
VFW_E_UNKNOWN_FILE_TYPE | The media type of this file is not recognized. |
VFW_E_UNSUPPORTED_STREAM | Cannot play the file: the format is not supported. |
Remarks
This method allows an application to pass the name of a media file that it wants rendered to the Filter Graph Manager. The Filter Graph Manager will build a graph of the filters needed to play back this file. This method is an Automation-compatible equivalent to the IGraphBuilder::RenderFile method.
See Also