ICaptureGraphBuilder2::RenderStream 智能连接方法浅析

ICaptureGraphBuilder2::RenderStream

HRESULT RenderStream(

  [in] const GUID        *pCategory,

  [in] const GUID        *pType,

  [in]       IUnknown    *pSource,

  [in]       IBaseFilter *pIntermediate,

  [in]       IBaseFilter *pSink

);

// pCategory 第一个参数指定一个引脚类别;

要预览图形，请使用PIN_CATEGORY_PREVIEW 要捕捉，请使用PIN_CATEGORY_CAPTURE

//pType 第二个参数指定一个媒体类型，作为一个主要类型的GUID。

对于视频，请使用MEDIATYPE_Video。

对于DV设备提供媒体类型为MEDIATYPE_Interleaved的交错音频和视频。

对于音频，请使用 MEDIATYPE_Audio

//pSource

第三个参数是一个指向捕获过滤器的IBaseFilter接口的指针。在这个例子中，接下来的两个参数是不需要的。它们用于指定可能需要呈现流的其他过滤器。将最后一个参数设置为NULL将导致Capture Graph Builder根据媒体类型为流选择一个默认渲染器。对于视频，Capture Graph Builder始终使用Video Renderer过滤器作为默认渲染器。
注意在Windows XP和更高版本中，虽然视频混合呈现器（VMR）是IGraphBuilder方法的默认视频呈现器，但它不是RenderStream方法的默认呈示器。在任何平台上，Capture Graph Builder始终使用旧的Video Renderer过滤器，除非您另行指定。
 
尽管引脚类别是以PIN_CATEGORY_PREVIEW的形式给出的，但是过滤器实际上是否有预览引脚并不重要，它可以有一个视频端口引脚或只是一个捕获引脚。无论哪种情况，Capture Graph Builder都会自动生成正确的图形。