プロジェクトをファイルに書き込む

[アーティクル]
06/21/2023

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

[この API はサポートされていないため、今後変更または使用できない可能性があります。]

この記事では、 DirectShow Editing Services プロジェクトをファイルに書き込む方法について説明します。最初に、基本的なレンダリングエンジンを使用してファイルを書き込む方法について説明します。次に、スマートレンダリングエンジンを使用したスマートな再圧縮について説明します。

DirectShow Editing Services によるプロジェクトのレンダリング方法の概要については、「レンダリングエンジンについて」を参照してください。

基本的なレンダリングエンジンの使用

まず、次のようにグラフのフロントエンドを作成します。

レンダリングエンジンを作成します。
タイムラインを指定します。
レンダリング範囲を設定します。 (省略可能)
グラフのフロントエンドを作成します。

次のコード例は、これらの手順を示しています。

IRenderEngine *pRender = NULL; 
hr = CoCreateInstance(CLSID_RenderEngine, NULL, CLSCTX_INPROC,
    IID_IRenderEngine, (void**) &pRender);

hr = pRender->SetTimelineObject(pTL);
hr = pRender->ConnectFrontEnd( );

次に、マルチプレクサーとファイル書き込みフィルターをフィルターグラフに追加します。これを行う最も簡単な方法は、キャプチャグラフを構築するための DirectShow コンポーネントである Capture Graph Builder です。キャプチャグラフビルダーは 、ICaptureGraphBuilder2 インターフェイスを 公開します。次の手順に従います。

キャプチャグラフビルダーのインスタンスを作成します。
グラフへのポインターを取得し、グラフビルダーに渡します。
出力ファイルの名前とメディアの種類を指定します。この手順では、後で必要になる mux フィルターへのポインターも取得します。

次のコード例は、これらの手順を示しています。

CoCreateInstance(CLSID_CaptureGraphBuilder2, NULL, CLSCTX_INPROC, 
    IID_ICaptureGraphBuilder2, (void **)&pBuilder);

// Get a pointer to the graph front end.
IGraphBuilder *pGraph;
pRender->GetFilterGraph(&pGraph);
pBuilder->SetFiltergraph(pGraph);

// Create the file-writing section.
IBaseFilter *pMux;
pBuilder->SetOutputFileName(&MEDIASUBTYPE_Avi, 
    OLESTR("Output.avi"), &pMux, NULL);

最後に、フロントエンドの出力ピンをマルチプレクサフィルタに接続します。

グループの数を取得します。
各ピンについて、ピンへのポインターを取得します。
必要に応じて、ストリームを圧縮する圧縮フィルターのインスタンスを作成します。コンプレッサーの種類は、グループのメディアの種類によって異なります。システムデバイス列挙子を使用して、使用可能な圧縮フィルターを列挙できます。詳細については、「デバイスとフィルターの列挙」を参照してください。
必要に応じて、キーフレームレートなどの圧縮パラメーターを設定します。この手順については、この記事の後半で詳しく説明します。
ICaptureGraphBuilder2::RenderStream を呼び出します。このメソッドは、ピン、圧縮フィルター (存在する場合)、マルチプレクサーへのポインターを受け取ります。

次のコード例は、出力ピンを接続する方法を示しています。

long NumGroups;
pTimeline->GetGroupCount(&NumGroups);

// Loop through the groups and get the output pins.
for (i = 0; i < NumGroups; i++)
{
    IPin *pPin;
    if (pRender->GetGroupOutputPin(i, &pPin) == S_OK) 
    {
        IBaseFilter *pCompressor;
        // Create a compressor filter. (Not shown.)
        // Set compression parameters. (Not shown.)

        // Connect the pin.
        pBuilder->RenderStream(NULL, NULL, pPin, pCompressor, pMux);
        pCompressor->Release();
        pPin->Release();
    }
}

圧縮パラメーター (前の手順 4) を設定するには、 IAMVideoCompression インターフェイスを使用します。このインターフェイスは、圧縮フィルターの出力ピンで公開されます。圧縮フィルターのピンを列挙し、 IAMVideoCompression の各出力ピンに対してクエリを実行します。 (ピンの列挙の詳細については、「ピンの列挙」を参照してください)。この手順で取得したすべてのインターフェイスポインターを必ず解放してください。

フィルターグラフを作成したら、フィルターグラフマネージャーで IMediaControl::Run メソッドを呼び出します。フィルターグラフを実行すると、データがファイルに書き込まれます。イベント通知を使用して、再生が完了するまで待機します。 (「イベントへの応答」を参照してください)。再生が完了したら、フィルターグラフを停止するには 、IMediaControl::Stop を明示的に呼び出す必要があります。それ以外の場合、ファイルは正しく書き込まれません。

スマートレンダリングエンジンの使用

スマートリ圧縮の利点を得るには、基本的なレンダリングエンジンの代わりにスマートレンダリングエンジンを使用します。グラフを作成する手順はほぼ同じです。主な違いは、圧縮は、ファイル書き込みセクションではなく、グラフのフロントエンドで処理される点です。

重要

Windows Media ファイルの読み取りまたは書き込みにスマートレンダリングエンジンを使用しないでください。

各ビデオグループには、そのグループの圧縮形式を指定するプロパティがあります。圧縮形式は、グループの非圧縮形式 (高さ、幅、ビット深度、フレームレート) と完全に一致している必要があります。スマートレンダリングエンジンは、グラフの作成時に圧縮形式を使用します。圧縮形式を設定する前に、 IAMTimelineGroup::SetMediaType を呼び出して、そのグループの非圧縮形式を設定してください。

グループの圧縮形式を設定するには、 IAMTimelineGroup::SetSmartRecompressFormat メソッドを呼び出します。このメソッドは、 SCompFmt0 構造体へのポインターを受け取ります。 SCompFmt0 構造体には、0 である必要がある nFormatId と、AM_MEDIA_TYPE構造体である MediaType の 2 つのメンバーがあります。形式情報を 使用して、AM_MEDIA_TYPE 構造体を初期化します。

注意

最終的なプロジェクトの形式をソースファイルの 1 つと同じにする場合は、メディア検出機能を使用して、ソースファイルから直接AM_MEDIA_TYPE構造を取得できます。 「IMediaDet::get_StreamMediaType」を参照してください。

次の例に示すように、 SCompFmt0 変数を long 型のポインターにキャストします。

SCompFmt0 *pFormat = new SCompFmt0;
memset(pFormat, 0, sizeof(SCompFmt0));
pFormat->nFormatId = 0;

// Initialize pFormat->MediaType. (Not shown.)

pGroup->SetSmartRecompressFormat( (long*) pFormat );

スマートレンダリングエンジンは、互換性のある圧縮フィルターを自動的に検索します。 ISmartRenderEngine::SetGroupCompressor を呼び出すことで、グループの圧縮フィルターを指定することもできます。

グラフを作成するには、前のセクションの基本レンダリングエンジンで説明したのと同じ手順を使用します。唯一の違いは次のとおりです。

基本的なレンダリングエンジンではなく、スマートレンダリングエンジンを使用します。クラス識別子がCLSID_SmartRenderEngine。
フロントエンドをビルドした後、出力ピンをレンダリングする前に圧縮パラメーターを設定します。グループの圧縮フィルターへのポインターを取得するには、 ISmartRenderEngine::GetGroupCompressor メソッドを呼び出します。次に、前に説明したように、 IAMVideoCompression インターフェイスのクエリを実行します。
出力ピンをレンダリングするときに、圧縮フィルターを挿入する必要はありません。ストリームは既に圧縮されています。

プロジェクトのレンダリング

次の方法で共有

プロジェクトをファイルに書き込む

フィードバック

その他のリソース

次の方法で共有

プロジェクトをファイルに書き込む

関連トピック

フィードバック

その他のリソース