IFilterGraph2::RenderEx メソッド (strmif.h)

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

メソッドは RenderEx 、既存のレンダラーのみを使用するオプションを使用して、出力ピンをレンダリングします。

構文

HRESULT RenderEx(
  [in]      IPin  *pPinOut,
  [in]      DWORD dwFlags,
  [in, out] DWORD *pvContext
);

パラメーター

[in] pPinOut

出力ピンの IPin インターフェイスへのポインター。

[in] dwFlags

ピンのレンダリング方法を指定するフラグ。 値がAM_RENDEREX_RENDERTOEXISTINGRENDERERSの場合、メソッドはフィルター グラフに既にレンダラーを使用しようとします。 グラフに新しいレンダラーは追加されません。 (必要に応じて中間変換フィルターが追加されます)。メソッドを成功させるには、グラフに適切なレンダラーが含まれている必要があり、接続されていない入力ピンが必要です。 値が 0 の場合、メソッドは IGraphBuilder::Render メソッドと同じように動作します。

[in, out] pvContext

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

戻り値

HRESULT を返します。

要件

こちらもご覧ください

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

IFilterGraph2 インターフェイス