次の方法で共有

IGraphBuilder::RenderFile メソッド (strmif.h)

  • [アーティクル]

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

メソッドは RenderFile 、指定したファイルをレンダリングするフィルター グラフを作成します。

構文

HRESULT RenderFile(
  [in] LPCWSTR lpcwstrFile,
  [in] LPCWSTR lpcwstrPlayList
);

パラメーター

[in] lpcwstrFile

メディア ファイルの名前を含むワイド文字列を指定します。

[in] lpcwstrPlayList

予約済み。 NULL にする必要があります。

戻り値

HRESULT を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_OK
 正常終了しました。
VFW_S_AUDIO_NOT_RENDERED
 部分的な成功。オーディオがレンダリングされませんでした。
VFW_S_DUPLICATE_NAME
 成功;フィルター グラフ マネージャーは、重複を避けるためにフィルター名を変更しました。
VFW_S_PARTIAL_RENDER
 このムービーのストリームの一部は、サポートされていない形式です。
VFW_S_VIDEO_NOT_RENDERED
 部分的な成功。このムービーのストリームの一部は、サポートされていない形式です。
E_ABORT
 操作は中止されました。
E_FAIL
 失敗しました。
E_INVALIDARG
 引数が無効です。
E_OUTOFMEMORY
 メモリ不足です。
E_POINTER
 NULL ポインター引数。
VFW_E_CANNOT_CONNECT
 中間フィルターの組み合わせが見つかり、接続を確立できませんでした。
VFW_E_CANNOT_LOAD_SOURCE_FILTER
 このファイルのソース フィルターを読み込めませんでした。
VFW_E_CANNOT_RENDER
 ストリームをレンダリングするためのフィルターの組み合わせが見つかりませんでした。
VFW_E_INVALID_FILE_FORMAT
 ファイル形式が無効です。
VFW_E_NOT_FOUND
 オブジェクトまたは名前が見つかりませんでした。
VFW_E_UNKNOWN_FILE_TYPE
 このファイルのメディアの種類が認識されません。
VFW_E_UNSUPPORTED_STREAM
 ファイルを再生できません。形式はサポートされていません。

注釈

lpwstrFile パラメーターでメディア ファイルが指定されている場合、メソッドは既定の再生用のフィルター グラフを作成します。 まず、 IGraphBuilder::AddSourceFilter メソッドと同じプロセスを使用して、ファイルを読み取ることができるソース フィルターを追加します。 次に、出力ピンをソース フィルターにレンダリングし、必要に応じて中間フィルターを追加します。 IGraphBuilder::Connect メソッドと同じ順序でフィルターを試行します。

接続プロセス中、ピン名がチルダ (~) で始まる場合、フィルター グラフ マネージャーは中間フィルターのピンを無視します。 詳細については、「 PIN_INFO」を参照してください。

メソッドは RenderFile グラフからフィルターを削除しないことに注意してください。 2 回呼び出 RenderFile した場合、2 回目の呼び出しでは、グラフにより多くのフィルターが追加されます。 グラフを実行すると、両方のソースが同時に再生されます。

例

次の例では、既定の再生用に AVI ファイルをレンダリングします。

C++ 
hr = pGraph->RenderFile(L"C:\\Media\\Example.avi", 0);
次の例では、 ファイル ソース (URL) フィルターを使用して、HTTP 経由で AVI ファイルをダウンロードします。
C++ 
hr = pGraph->RenderFile(L"http://example.microsoft.com/Example.avi", 0);

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー strmif.h (Dshow.h を含む)
Library Strmiids.lib

こちらもご覧ください

エラーコードと成功コード

IGraphBuilder インターフェイス