IltmmConvert::GetClosedCaptioningTargetFile

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert__GetClosedCaptioningTargetFile(pConvert, filename, pFlags)
C++ Syntax	HRESULT GetClosedCaptioningTargetFile(filename, pFlags)

IltmmConvert *pConvert;	/* pointer to an interface */
BSTR* filename;	/* pointer to a BSTR value*/
long* pFlags;	/* pointer to a long value*/

Retrieves the filename and flags set using the.IltmmConvert::SetClosedCaptioningTargetFile method.

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
filename	Pointer to a string to be updated with the filename to which the closed captioning information will be saved.
pFlags	Pointer to a long value to be updated with save flags. For a list of possible values, refer to ltmmClosedCaptioning_Flag Constants.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Retrieves the filename and flags set by the IltmmConvert::SetClosedCaptioningTargetFile method. If no filename has been set It returns NULL and zero flags .If a filename has been set and it returns zero flags it means that it is set to save closed captioning information as an SRT file.

If the method succeeds, free the returned string by calling the SysFreeString function.

For more information, refer to IltmmConvert::SetClosedCaptioningTargetFile.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Mobile

See Also

Elements:	IltmmPlay::get_CloseCaptioning, IltmmPlay::put_CloseCaptioning, IltmmPlay::ToggleCloseCaptioning, IltmmConvert::GetClosedCaptioningTargetFile , IltmmConvert::SetClosedCaptioningTargetFile, IltmmCapture::get_CloseCaptioning, IltmmCapture::get_PreviewingCloseCaption, IltmmCapture::put_CloseCaptioning, IltmmCapture::ToggleCloseCaptioning, IltmmConvert::get_AllowedStreams
Topics:	Multimedia Function Groups
	Closed Captioning

Example

For a C++ example, refer to IltmmConvert::SetClosedCaptioningTargetFile Example for C++.