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 |