ICaptureGraphBuilder2::SetOutputFileName メソッド (strmif.h)

  • [アーティクル]

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

メソッドは SetOutputFileName 、フィルター グラフのファイル書き込みセクションを作成します。

構文

HRESULT SetOutputFileName(
  [in]  const GUID      *pType,
  [in]  LPCOLESTR       lpstrFile,
  [out] IBaseFilter     **ppf,
  [out] IFileSinkFilter **ppSink
);

パラメーター

[in] pType

出力のメディア サブタイプ、またはマルチプレクサー フィルターまたはファイル ライター フィルターのクラス識別子 (CLSID) を表す GUID へのポインター。 メディア サブタイプを指定する場合は、次のいずれかである必要があります。

値 説明
MEDIASUBTYPE_Avi Audio-Video Interleaved (AVI)
MEDIASUBTYPE_Asf Advanced Systems Format (ASF)

[in] lpstrFile

出力ファイル名を含むワイド文字列へのポインター。

[out] ppf

マルチプレクサーの IBaseFilter インターフェイスを受け取るポインターのアドレス。

[out] ppSink

ファイル ライターの IFileSinkFilter インターフェイスを受け取るポインターのアドレス。 NULL を指定できます。

戻り値

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

リターン コード 説明
S_OK
 正常終了しました。
E_FAIL
 失敗しました。
E_POINTER
 NULL ポインター引数。

注釈

このメソッドは、 pType パラメーターの値に基づいてマルチプレクサー フィルターを作成します。 AVI の場合、 AVI 多重化フィルターが作成されます。 ASF の場合、 WM ASF ライターが作成されます。 その他の値の場合は、CLSID によって識別されるフィルターが作成されます。 フィルター グラフにマルチプレクサーを追加し、ppf パラメーターで IBaseFilter インターフェイスへのポインターを返します。

マルチプレクサーが IFileSinkFilter インターフェイスをサポートしている場合、メソッドは lpwstrFile パラメーターで指定された値を使用して IFileSinkFilter::SetFileName を呼び出して出力ファイル名を設定します。 マルチプレクサーが IFileSinkFilter インターフェイスをサポートしていない場合、メソッドは ファイル ライター フィルター をフィルター グラフに追加し、マルチプレクサーをファイル ライターに接続し、ファイル ライターの IFileSinkFilter インターフェイスを使用して SetFileName を呼び出します。 pSink パラメーターが NULL でない場合は、IFileSinkFilter インターフェイスへのポインターを受け取ります。

iCaptureGraphBuilder2::RenderStream メソッドの pSink パラメーターとして、ppf パラメーターで返されるマルチプレクサー フィルターへのポインターを使用できます。

カスタム マルチプレクサー フィルターの場合、入力ピンが接続される前にフィルターが出力ピンの接続をサポートしていない場合、メソッドは失敗します。 たとえば、SDK に含まれる WavDest フィルター サンプル には、この制限があります。

メソッドが成功した場合、ppf パラメーターで返される IBaseFilter インターフェイスには未処理の参照カウントがあります。 メソッドが成功し、 pSink が NULL でない場合、 IFileSinkFilter インターフェイスにも未処理の参照カウントがあります。 両方のインターフェイスの使用が完了したら、必ず両方のインターフェイスを解放してください。

要件

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

こちらもご覧ください

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

ICaptureGraphBuilder2 インターフェイス