Share via


IStreamBufferCapture::BeginPermanentRecording (Windows Embedded CE 6.0)

1/6/2010

This method is used by a client DVR application to initiate a permanent recording. If the previous recording was temporary, then this method converts that temporary recording to a permanent recording. If the previous recording was permanent then the call to this method represents a transition from one permanent recording to another.

Syntax

HRESULT BeginPermanentRecording(
  LONGLONG  hyRetainedSizeInMilliseconds,
  LONGLONG* phyActualRetainedSizeInMillisecs
);

Parameters

  • hyRetainedSizeInMilliseconds
    [in] A LONGLONG value that specifies the amount time, in milliseconds, from the end of a temporary recording to transfer to the beginning of a new permanent recording. This parameter is only meaningful if the previous recording was temporary.

    If the temporary recording is shorter than hyRetainedSizeInMilliseconds then the entire temporary recording is converted to a permanent recording. The new permanent recording created from a temporary recording will take on the name of the temporary recording.

  • phyActualRetainedSizeInMillisecs
    [out] A pointer to a LONGLONG value that identifies how many milliseconds, if any, from the previous temporary recording were transferred to the beginning of the new permanent recording.

Return Value

Returns one of the following values.

Value Description

E_FAIL

The method was unable to create the new file

S_OK

The method was successful

When beginning a permanent recording, the client will call BeginPermanentRecording(). Then the client must ask the Writer's IFileSinkFilter2 to obtain the name of the new recording.

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

IStreamBufferCapture Interface