Share via


IStreamBufferCapture Interface (Windows Embedded CE 6.0)

1/6/2010

This interface is used by digital video recorder (DVR) applications during initialization to configure a capture graph for either permanent or temporary recording. This interface can also be used to reconfigure a capture graph for temporary recordings into a capture graph for permanent recordings, and vice versa. The DVR application can specify how much of a temporary recording to retain as that temporary recording is converted to a permanent recording.

This interface can also be used to end a permanent recording and start a new one.

When the client transitions to a new temporary recording, the client specifies the pause window's buffer size.

The capture graph will start a temporary recording with an effectively infinite pause buffer size when the capture graph is first set up. The client application will normally override that behavior before starting the capture graph.

Methods

The following table shows the methods for this interface. Like all COM interfaces, this interface inherits the methods for the IUnknown interface.

Method Description

BeginPermanentRecording

Used by a client DVR application to initiate a permanent recording.

BeginTemporaryRecording

Used by a client DVR application to begin a temporary recording.

ConvertToTemporaryRecording

Allows a client DVR application to convert a temporary recording to a permanent recording.

GetBoundToLiveToken

Used to obtain the token that the filter graph exports to identify that the graph can be bound to a live-TV stream.

GetCaptureMode

Identifies the size of the pause buffer and whether the current capture mode is set for permanent or temporary recordings.

GetCurrentPosition

Reports the current position of the capture graph. Use this method to coordinate external events with a recording that is already in progress.

GetRecordingPath

Used to obtain the path to the root directory where recordings are currently being stored.

SetRecordingPath

Sets the path to the root directory where recordings will be stored.

Requirements

Windows Embedded CE Windows CE 5.0 Networked Media Device Feature Pack and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment

See Also

Reference

DirectShow Interfaces