IRenderEngine インターフェイス
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
注意
[非推奨。 この API は、Windows の今後のリリースから削除される可能性があります。]
インターフェイスはIRenderEngine、タイムラインからフィルター グラフを構築することで、DirectShow Editing Services (DES) プロジェクトをレンダリングします。
DES には、このインターフェイスを実装する 2 つのコンポーネントが用意されています。
- 基本的なレンダリング エンジンは、圧縮されていない出力を作成します。 プレビューの出力を使用するか、圧縮フィルターを使用してルーティングしてファイルに書き込むことができます。
- スマート レンダリング エンジンは、スマート再圧縮を使用して圧縮された出力を作成します。 スマート再圧縮では、ソース ファイルの形式が出力形式と異なる場合にのみ、再圧縮されます。 形式が一致するソースは、出力ファイルに直接書き込まれます。 シナリオによっては、スマートな再圧縮によってレンダリング時間が大幅に短縮されます。
スマート レンダリング エンジンでは、 ISmartRenderEngine インターフェイスもサポートされています。
アプリケーションはフィルター グラフを作成してレンダリング エンジンに渡すことができますが、一般的なシナリオは、レンダリング エンジンがフィルター グラフを作成することです。 グラフの作成は 2 段階のプロセスです。 まず、 IRenderEngine::ConnectFrontEnd メソッドを呼び出してフロントエンドをビルドします。 次に、フロントエンドの出力ピンを目的のレンダリング フィルターに接続します。
- プレビュー用のビデオおよびオーディオ レンダラー、または
- 最終的な出力を生成するコンプレッサー、マルチプレクサー、およびファイル ライター。
メンバー
IRenderEngine インターフェイスは、IUnknown インターフェイスから継承されます。 IRenderEngine には、次の種類のメンバーもあります。
メソッド
IRenderEngine インターフェイスには、これらのメソッドがあります。
| メソッド | 説明 |
|---|---|
| Commit | 実装されていません。 |
| ConnectFrontEnd | 現在のタイムラインからフィルター グラフのフロントエンドを構築します。 |
| デコミット | 実装されていません。 |
| DoSmartRecompression | サポートされていません。 |
| GetCaps | 実装されていません。 |
| GetFilterGraph | レンダリング エンジンが構築したフィルター グラフ (存在する場合) を取得します。 |
| GetGroupOutputPin | 指定したグループの出力ピンを取得します。 |
| GetTimelineObject | レンダリング エンジンが現在使用しているタイムラインを取得します。 |
| GetVendorString | ベンダー文字列を取得します。 |
| RenderOutputPins | フィルター グラフのプレビュー部分を作成します。 |
| ScrapIt | レンダリング エンジンのフィルター グラフと、関連付けられているすべてのオブジェクトを破棄します。 |
| SetDynamicReconnectLevel | レンダリング中の動的再接続のレベルを設定します。 |
| SetFilterGraph | レンダリング エンジンで使用するフィルター グラフを指定します。 |
| SetInterestRange | サポートされていません。 |
| SetInterestRange2 | サポートされていません。 |
| SetRenderRange | レンダリングする時間の範囲を設定します。 |
| SetRenderRange2 | レンダリングする時間の範囲を 倍精度浮動小数点型 (double) として設定します。 |
| SetSourceConnectCallback | サポートされていません。 |
| SetSourceNameValidation | レンダリング エンジンがファイル名を検証する方法を指定します。 |
| SetTimelineObject | 使用するレンダー エンジンのタイムラインを設定します。 |
| UseInSmartRecompressionGraph | サポートされていません。 |
解説
注意
ヘッダー ファイル Qedit.h は、バージョン 7 より後の Direct3D ヘッダーと互換性がありません。
注意
Qedit.h を取得するには、Windows Vista および .NET Framework 3.0 用の Microsoft Windows SDK Update をダウンロードします。 Qedit.h は、Windows 7 および .NET Framework 3.5 Service Pack 1 のMicrosoft Windows SDKでは使用できません。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|
関連項目