One

Un

Two

Deux

Three

Trois





The STYLE tag defines two language settings, English (.ENCC) and French (.FRCC). It also defines two styles, #NORMAL and #GREENTEXT. Each SYNC tag defines the start time for a caption, in milliseconds. The P tags contain the caption text, while the CLASS attribute specifies the language setting to which the caption applies.



For each language and style, the filter creates a logical stream. At any time, exactly one language stream and one style stream are enabled. When the filter generates a sample, it selects the caption for the current language and applies the current style. By default, the first language and style declared in the file are enabled. An application can use the IAMStreamSelect::Enable method to enable a different stream.



With the default settings, the first caption in the example file produces the following output:

One

If the output goes to the Internal Script Command Renderer, that filter sends an EC_OLE_EVENT event notification. The second event parameter is a BSTR with the caption text. The application can retrieve the event and display the caption.



The following example shows how to render a SAMI file, retrieve stream information, enable streams, and display caption text. The example assumes that the previous SAMI file is saved as C:Sami_test_file.sami. For brevity, the example used hard-coded stream indexes when it calls the IAMStreamSelect::Enable method:



void __cdecl main()

{

HRESULT hr;

IGraphBuilder *pGraph;

IMediaControl *pMediaControl;

IMediaEventEx *pEv;

IBaseFilter *pSAMI;



CoInitialize(NULL);



// Create the filter graph manager.

CoCreateInstance(CLSID_FilterGraph, NULL, CLSCTX_INPROC,

IID_IGraphBuilder, (void **)&pGraph);

pGraph->QueryInterface(IID_IMediaControl, (void **)&pMediaControl);

pGraph->QueryInterface(IID_IMediaEventEx, (void**)&pEv);



// Create the graph and find the SAMI parser.

pGraph->RenderFile(L"C:Sami_test_file.sami", NULL);

hr = pGraph->FindFilterByName(L"SAMI (CC) Parser", &pSAMI);

if (SUCCEEDED(hr))

{

IAMStreamSelect *pStrm = NULL;

hr = pSAMI->QueryInterface(IID_IAMStreamSelect, (void**)&pStrm);

if (SUCCEEDED(hr))

{

DWORD dwStreams = 0;

pStrm->Count(&dwStreams);

printf("Stream count: %dn", dwStreams);



// Select French and "GreenText"

hr = pStrm->Enable(1, AMSTREAMSELECTENABLE_ENABLE);

hr = pStrm->Enable(3, AMSTREAMSELECTENABLE_ENABLE);



// Print the name of each logical stream.

for (DWORD index = 0; index < dwStreams; index++)

{

DWORD dwFlags;

WCHAR *wszName;

hr = pStrm->Info(index, NULL, &dwFlags, NULL, NULL, &wszName, NULL, NULL);

wprintf(L"Stream %d: %s [%s]n", index, wszName,

(dwFlags ? L"ENABLED" : L"DISABLED"));

CoTaskMemFree(wszName);

}

pStrm->Release();

}

pSAMI->Release();

}



// Run the graph and display the captions.

pMediaControl->Run();

while (1)

{

long evCode, lParam1, lParam2;

pEv->GetEvent(&evCode, &lParam1, &lParam2, 100);



if (evCode == EC_OLE_EVENT) {

wprintf(L"%sn", (BSTR)lParam2);

}

pEv->FreeEventParams(evCode, lParam1, lParam2);



if (evCode == EC_USERABORT || evCode == EC_COMPLETE || evCode == EC_ERRORABORT)

break;

}



// Clean up.

pMediaControl->Release();

pEv->Release();

pGraph->Release();

CoUninitialize();

}