World Standard Teletext の表示

[アーティクル]
07/28/2023

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオキャプチャに置き換わりました。これらの機能は、Windows 10とWindows 11用に最適化されています。新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

注意

この機能は、Windows Vista 以降のオペレーティングシステムから削除されました。 Microsoft Windows 2000、Windows XP、および Windows Server 2003 オペレーティングシステムで使用できます。

World Standard Teletext (WST) は、アナログテレビ信号の垂直ブランキング間隔 (VBI) でエンコードされます。テレテキストをプレビューするためのフィルターグラフは、クローズドキャプションの表示に使用されるグラフに似ています。次の図は、このグラフを示しています。

wst プレビューグラフ

このグラフでは、WST 表示に次のフィルターを使用します。

Tee/Sink-to-Sink コンバーター。キャプチャフィルターから VBI 情報を受け入れ、シグナルに存在するデータサービスごとに個別のストリームに分割します。
WST コーデック。 VBI サンプルから Teletext データをデコードします。
WST デコーダー。テレテキストデータを変換し、テキストをビットマップに描画します。ダウンストリームフィルター (この場合はオーバーレイミキサー) は、ビットマップをビデオにオーバーレイします。

Capture Graph Builder の RenderStream メソッドは WST フィルターを直接サポートしていないため、アプリケーションで追加の作業を行う必要があります。

オーバーレイミキサーフィルターをフィルターグラフに追加します。次のコードでは、「 CLSID によるフィルターの追加」で説明されている AddFilterByCLSID 関数を使用します。 (AddFilterByCLSID は DirectShow API ではありません)。
```
IBaseFilter *pOvMix = NULL;  // Pointer to the Overlay Mixer filter.
hr = AddFilterByCLSID(pGraph, CLSID_OverlayMixer, L"OVMix", &pOvMix);
if (FAILED(hr)) 
{
    // Handle the error ...
}
```
オーバーレイミキサーを使用して、プレビューピンをビデオレンダラーフィルターに接続します。 RenderStream メソッドは、次のように使用できます。
```
hr = pBuild->RenderStream(&PIN_CATEGORY_PREVIEW, &MEDIATYPE_Video, 
    pCap, pOvMix, 0);
```
Tee/Sink-to-Sink Converter フィルターをフィルターグラフに追加します。次のコードでは、「 Kernel-Mode フィルターの作成」で説明されている CreateKernelFilter 関数を使用します。 (CreateKernelFilter は DirectShow API ではありません)。
```
IBaseFilter* pKernelTee = NULL;
hr = CreateKernelFilter(AM_KSCATEGORY_SPLITTER, 
    OLESTR("Tee/Sink-to-Sink Converter"), &pKernelTee);
if (SUCCEEDED(hr))
{
    hr = pGraph->AddFilter(pKernelTee, L"Kernel Tee");
}
```

WST コーデックフィルターをフィルターグラフに追加します。

IBaseFilter* pWstCodec = NULL;
hr = CreateKernelFilter(AM_KSCATEGORY_VBICODEC, 
    OLESTR("WST Codec"), &pWstCodec);
if (SUCCEEDED(hr))
{
    hr = pGraph->AddFilter(pWstCodec, L"WST Codec");
}

RenderStream を呼び出して、キャプチャフィルターの VBI ピンを Tee/Sink-to-Sink コンバーターに接続し、Tee/Sink-to-Sink Converter を WST コーデックフィルターに接続します。
```
hr = pBuild->RenderStream(&PIN_CATEGORY_VBI, 0, pCap, 
    pKernelTee, pWstCodec);
```
再び RenderStream を呼び出して、WST コーデックフィルターをオーバーレイミキサーに接続します。 WST デコーダーフィルターが自動的にグラフに取り込まれる。
```
hr = pBuild->RenderStream(0, 0, pWstCodec, 0, pOvMix);
```
すべてのフィルターインターフェイスを解放することを忘れないでください。
```
pOvMix->Release();
pKernelTee->Release();
pWstCodec->Release();
```

注意

現在、WST デコーダーフィルターでは、ビデオ混合レンダラー (VMR) フィルターへの接続はサポートされていません。したがって、テレテキストを表示するには、従来のビデオレンダラーフィルターを使用する必要があります。

キャプチャフィルターにビデオポート VBI ピン (PIN_CATEGPORY_VIDEOPORT_VBI) がある場合は、 VBI Surface Allocator フィルターに接続します。それ以外の場合、グラフは正しく実行されません。次のコード例では、「 CLSID によるフィルターの追加」で説明されている AddFilterByCLSID 関数と、「ピンカテゴリの操作」で説明されている FindPinByCategory 関数を使用します。 (どちらの関数も DirectShow API でもありません。

// Look for a video port VBI pin on the capture filter.
IPin *pVPVBI = NULL;
hr = FindPinByCategory(pCap, PINDIR_OUTPUT, 
    PIN_CATEGORY_VIDEOPORT_VBI, &pVPVBI);
if (FAILED(hr))
{
    // No video port VBI pin; nothing else to do. OK to run the graph.
}
else
{
    // Found one. Connect it to the VBI Surface Allocator.
    IBaseFilter *pSurf = NULL;
    hr = AddFilterByCLSID(pGraph, CLSID_VBISurfaces, L"VBI Surf", &pSurf);
    if (SUCCEEDED(hr))
    {
        hr = pBuild->RenderStream(NULL, NULL, pVPVBI, 0, pSurf);
        pSurf->Release();
    }
    if (FAILED(hr))
    {
        // Handle the error (not shown). It is probably not safe to 
        // run the graph at this point.
    }
    pVPVBI->Release();
}

クローズドキャプションとテレテキスト

次の方法で共有

World Standard Teletext の表示

フィードバック

その他のリソース

次の方法で共有

World Standard Teletext の表示

関連トピック

フィードバック

その他のリソース