DirectX でデジタル TV アプリケーションを書く

[アーティクル]
04/22/2010

この節では、ビデオコントロールを使用できない下位プラットフォーム用のデジタル TV フィルタグラフを作成する方法について説明する。このようなプラットフォームでは、アプリケーションはデジタル TV グラフを手動で作成し、各フィルタの追加や接続をしなければならない (キャプチャグラフビルダオブジェクトはデジタル TV グラフをサポートしないことに注意)。BDA サンプルアプリケーションでは、基本的なデジタル TV フィルタグラフを作成する方法が紹介されている。

チューニング要求の取得

最初にチューニング要求を取得する。ガイドストアから取得するか、またはアプリケーション内でプログラム的に作成する。詳細については、「Microsoft 統合チューニングモデル」を参照すること。

ネットワークプロバイダフィルタの作成

デジタル TV フィルタグラフに最初に表示されるフィルタは、BDA ネットワークプロバイダフィルタである。ネットワークプロバイダはチューニングを制御し、トランスポート情報フィルタ (TIF) と連携して、トランスポートストリームから番組情報を取得する。ネットワークプロバイダフィルタを選択するには、チューニング空間のネットワークタイププロパティを問い合わせる。ネットワークタイププロパティはそのチューニング空間で使われるネットワークプロバイダの CLSID に対応している。次のコードは、ネットワークプロバイダを作成してグラフに追加する方法を示している。

CComPtr<ITuneRequest> pTuneRequest;  // チューニング要求
CComPtr<ITuningSpace> pTuningSpace;  // チューニング空間
CComPtr<IBaseFilter> pNetworkProvider; // ネットワーク プロバイダ フィルタ
GUID CLSIDNetworkType; // ネットワーク タイプの GUID。

// チューニング要求を初期化する (省略)。

// このチューニング要求のチューニング空間を見つける。
hr = pTuneRequest->get_TuningSpace(&pTuningSpace);
if (FAILED(hr))
{
        // エラーを処理する。
}

// ネットワーク タイプを見つける。
hr = pTuningSpace->get__NetworkType(&CLSIDNetworkType);
if (FAILED(hr))
{
        // エラーを処理する。
}
if (CLSID_NetworkType == GUID_NULL)
{
        // このチューニング空間はアナログ TV、AuxIn、またはその他の非 BDA タイプである。
}
else
{
        // このネットワーク タイプ用のネットワーク プロバイダ フィルタを作成する。
    hr = pNetworkProvider.CoCreateInstance(CLSIDNetworkType);
    if (SUCCEEDED(hr))
    {
                // ネットワーク プロバイダをグラフに追加する。
        hr = pGraph->AddFilter(pNetworkProvider, L"Network Provider");
    }
}

ITuneRequest::get_TuningSpace メソッドは、特定のチューニング要求のチューニング空間へのポインタを取得する。次に、ITuningSpace::get__NetworkType を呼び出してネットワークタイプ GUID を取得する。この GUID を CoCreateInstance 関数に渡してネットワークプロバイダフィルタを作成する。

アナログチューニング空間

一部のチューニング空間では、ネットワークタイプが GUID_NULL である。これは、チューニング空間がデジタル TV ネットワークを表さないことを意味する。そのため、BDA ネットワークプロバイダフィルタはこのチューニング空間を処理しない。この場合、アプリケーションでは、「ビデオキャプチャ」および「アナログ TV」の節にある説明に従って、アナログ TV キャプチャグラフを作成する必要がある。チューニング要求上のチャンネル番号は、TV チューナーフィルタ上に設定するチャンネルを示す。

AuxInTuningSpace チューニング空間は、補助ビデオ入力または "AuxIn" を表す。チャンネル番号は入力ソースを示す。

チャンネル番号	入力
0	S ビデオ
1	合成ビデオ

チューニング要求が AuxIn タイプかどうかを確認するには、チューニング空間の IAuxInTuningSpace インターフェイスを問い合わせる。このインターフェイスが公開されている場合は、アナログキャプチャグラフを作成し、クロスバーフィルタを使用して入力ソースを選択する。詳細については、「クロスバーの操作」を参照すること。S ビデオの場合は、PhysConn_Video_SVideo ピンをビデオ出力ピンにルーティングする。合成ビデオの場合は、PhysConn_Video_Composite ピンをビデオ出力にルーティングする。両方の場合に、PhysConn_Audio_Line ピンをオーディオ出力にルーティングする。

アナロググラフの場合、この節の以降の部分は無視してかまわない。

ネットワークプロバイダへのチューニング要求の送信

ネットワークプロバイダをグラフに追加した後、チューニング要求へのポインタを指定してネットワークプロバイダの ITuner インターフェイスを問い合わせ、ITuner::put_TuneRequest を呼び出す。

// ITuner を問い合わせる。
CComQIPtr<ITuner> pTuner(pNetworkProvider);
if (pTuner)
{
        // ネットワーク プロバイダにチューニング要求を送信する。
    hr = pTuner->put_TuneRequest(pTuneRequest);
}

残りのフィルタの追加と接続

チューニング要求のネットワークプロバイダを構成した後、残りのフィルタをグラフに追加できる。ネットワークプロバイダは、"BDA ソースフィルタ" カテゴリのチューナーフィルタ (KSCATEGORY_BDA_NETWORK_TUNER) に接続するチューナーフィルタは、"" カテゴリの 1 つ以上のフィルタ (KSCATEGORY_BDA_RECEIVER_COMPONENT) に接続する。このカテゴリには、ハードウェアに応じて、キャプチャフィルタまたはデモジュレータフィルタが含まれる。アプリケーションでは、メディアタイプ別またはメディア別にこのカテゴリのフィルタを列挙し、フィルタを接続する必要がある。

キャプチャフィルタを MPEG-2 デマルチプレクサに接続する。すると、優先コンポーネントタイプに基づいて出力ピンが自動的に構成される。通常、ピン 1 は BDA MPEG-2 トランスポート情報フィルタ (TIF) に接続する。通常は、すべての出力ピンをデマルチプレクサ上にレンダリングすれば、正しいレンダラフィルタがグラフに追加される。IP データの場合は、デマルチプレクサ上の出力ピンを BDA MPE フィルタ経由で BDA IP シンクフィルタに接続する。

デフォルト優先コンポーネントタイプの定義

"コンポーネント" はプログラムサブストリームを表す。デフォルト優先コンポーネントタイプは、ユーザーがデフォルトでアクティブにすることを望むタイプのサブストリームである。たとえば、スペイン語のオーディオストリームが利用可能なときはいつもそれを再生するように指定するユーザーもいる。アプリケーションは空のコンポーネントコレクションオブジェクトをインスタンス化し、それに書き込むことによって優先コンポーネントセットを作成する。次にアプリケーションはそのコンポーネントオブジェクトを持続するように保存するか、チューナーに送る。またはその両方を行う。チューナーは利用可能なサブストリームに変更があると必ずコンポーネントオブジェクトをチェックする。

サブストリームの選択

どのサブストリームをアクティブまたは非アクティブにするかを指定するには、アプリケーションは最初にチューニング要求をチューナーに送らなければならない。チューナーが指定したチャンネルや周波数をチューニングすると、チューナーはチューニング要求のコンポーネントコレクションにアクティブまたは非アクティブな各サブストリームの情報を書き込む。次にアプリケーションはこのコレクション内の各コンポーネントを調べ、IComponent::put_Status メソッドを使って個々のサブストリームをアクティブまたは非アクティブにすることができる。

デジタルチューニング

最初のチューニング要求が送られた後、次のチューニングは新しいチューニング要求をネットワークプロバイダに送ることによって行われる。

次の方法で共有

DirectX でデジタル TV アプリケーションを書く

その他のリソース