IRenderEngine::GetGroupOutputPin

GetGroupOutputPin メソッドは、指定したグループの出力ピンを取得する。

構文

  HRESULT GetGroupOutputPin(
    long Group,
    IPin **ppRenderPin
);

パラメータ

Group

グループを指定するゼロから始まるインデックス値。

ppRenderPin

[out] 出力ピンの IPin インターフェイスを受け取るポインタのアドレス。

戻り値

HRESULT 値を返す。次のいずれかの値を返す。

値	説明
S_FALSE	グループは出力ピンを持っていない。
S_OK	成功。
E_INVALIDARG	無効な引数。
E_MUST_INIT_RENDERER	レンダリングエンジンが初期化に失敗した。
E_POINTER	無効なポインタ。
E_RENDER_ENGINE_IS_BROKEN	プロジェクトが正しくレンダリングされなかったため、処理が失敗した。
E_UNEXPECTED	予期せぬエラー。

注意

このメソッドを呼び出す前に、IRenderEngine::ConnectFrontEnd を呼び出してグラフのフロントエンドを作成する。各グループは単一のメディアストリームを表し、フロントエンドには対応する出力ピンがある。

このメソッドを使ってファイル書き込みグラフのレンダリング部分を作成できる。出力ピンをマルチプレクサフィルタおよびファイルライタフィルタに接続する。詳細については、「プロジェクトのレンダリング」を参照すること。

プレビューの場合は、このメソッドを呼び出す必要はない。単純に、ConnectFrontEnd の後に IRenderEngine::RenderOutputPins を呼び出せばよい。

メソッドが S_OK を返した場合、返される IPin インターフェイスに未処理の参照カウントが残る。使用後、インターフェイスを必ず解放すること。

要件

ヘッダー : Qedit.h をインクルードする。このヘッダーファイルは、バージョン 7 以降の Microsoft® Direct3D® のヘッダーとは互換性がない。

ライブラリ : strmiids.lib を使用。

参照

その他のリソース