Video Port Pins in File Capture

Microsoft DirectShow 9.0

Video Port Pins in File Capture

If the capture device has a video port, the video port pin must be connected to a video renderer, even if you only want to capture to a file.

If you call ICaptureGraphBuilder2::RenderStream with the value PIN_CATEGORY_CAPTURE and the device has a video port pin, the Capture Graph Builder automatically connects the video port pin to the Overlay Mixer filter and connects the Overlay Mixer to the Video Renderer. The Capture Graph Builder hides the video window by calling IVideoWindow::put_AutoShow with the value OAFALSE. If the application later calls RenderStream with PIN_CATEGORY_PREVIEW, the Capture Graph Builder calls put_AutoShow with the value OATRUE, in order to show the video window.

After you call RenderStream with PIN_CATEGORY_CAPTURE, you can check whether it has added the Video Renderer by querying the Filter Graph Manager for the IVideoWindow interface.