IStreamBufferCapture Interface (Windows CE 5.0)
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
DirectShow applications and DirectShow filters have different include file and link library requirements.
For more information, see Setting Up the Build Environment.
OS Versions: Windows CE 5.0 with Windows CE 5.0 Networked Media Device Feature Pack
See Also
Send Feedback on this topic to the authors